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Utilisation de Borland C++ pour 
Windows 



Cette section du Guide de Vutilisateur indique comment installer et utiliser 
Borland C++. Elle vous apprend a vous servir de ses divers composants 
dans l'environnement de developpement integre (EDI) : le debogueur 
integre, Browser, AppExpert, ClassExpert et le gestionnaire de projet. Elle 
fournit en outre une documentation sur les outils en ligne de commande : le 
compilateur, l'editeur de liens, le bibliothecaire et l'outil MAKE. 

Borland C++ possede les caracteristiques suivantes : 

■ Developpement integre d'applications DOS, Windows, WIN32S et Windows 
NT. Vous pouvez concevoir plusieurs applications a partir d'un seul fichier 
projet. 

■ Creation rapide et facile d'applications ObjectWindows grace a AppExpert. 
Lorsque vous avez cree votre application, ClassExpert vous aide a en 
effectuer la maintenance en assurant le suivi des classes et des evenements, 
et se combine avec Resource Workshop pour gerer les ressources que vous y 
utilisez. 

■ Aide au debogage des applications sans passer par un debogueur separe. 

■ Editeur personnalisable. Vous pouvez vous servir des raccourcis clavier 
fournis avec Borland C++ ou creer les votres. 

Cette section aborde egalement deux programmes Windows d'aide au 
debogage d'applications : WinSight et WinSpector. 



Deux fichiers en ligne sont disponibles a propos de Borland C++ ; ils 
contiennent des informations complementaires qui ne figurent ni dans les 
manuels, ni dans l'aide en ligne. 

■ INSTALL.TXT Presente des informations completes sur 

l'installation a partir de disquettes ou de CD-ROM. 

■ UTILS.TXT Decrit les outils et utilitaires en ligne de 

commande non presentes dans les manuels et 
l'aide en ligne. 



Pour commencer 



Borland C++ est un ensemble professionnel de developpement contenant 
des outils Windows, des outils en ligne de commande et des bibliotheques. 
II vous permettra de creer des applications pour DOS, Windows, Win32s et 
Windows NT. Ce chapitre vous explique comment utiliser Borland C++ : 
l'EDI, le gestionnaire de projets, AppExpert, les outils et les divers utilitaires. 

Dans ce chapitre, vous apprendrez a 

■ Installer et configurer Borland C++ 

■ Utiliser l'editeur 

■ Utiliser la mise en surbrillance de la syntaxe dans votre code 

■ Utiliser la barre d'icones 

■ Utiliser la fenetre de messages 

■ Vous deplacer dans votre code 

■ Utiliser les outils de l'EDI 

Les autres utilitaires et les outils en ligne de commande ne sont decrits ici 
que succinctement. Pour de plus amples informations sur les autres 
modules de Borland C++, consultez le Roadmap, qui vous indiquera ou 
trouver vos informations dans la documentation. 



Installation de Borland C++ 



Borland C++ contient des applications DOS et Windows. Avant de 
l'installer, verifiez que votre configuration repond aux besoins indiques 
ci-dessous. 



Configuration Pour utiliser Borland C++, il vous faut : 

materielle et ^ __ . , „„ , , . 

■ DOS version 4.01 ou ulteneure 



logicielle requise 



Windows 3.1 ou toute version ulterieure executee en mode 386 etendu 
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Procedure 

d'installation 



Si vous utilisez un 

utilitaire de 

compression de 

fichiers, lisez 

attentivement le fichier 

INSTALL.TXT avantde 

proceder a I'installation 

de Borland C++. 



■ Un disque dur avec 40 Mo de libres (80 Mo pour I'installation complete) 

■ Un lecteur de disquette de 1,44 Mo ou un lecteur de CD-ROM (pour 
I'installation) 

■ 4 Mo de memoire etendue 

■ Une souris compatible Windows 

Les elements ci-dessous, bien que non indispensables, vous permettront de 
tirer le meilleur parti de votre nouveau logiciel : 

■ 8 Mo de memoire vive 

■ Un coprocesseur 80x87 (si vous utilisez les bibliotheques de calcul en 
virgule flottante). Notez cependant que Borland C++ emule ce composant 
s'il ne detecte pas sa presence. 

Le programme d'installation installe l'environnement Borland C++ (l'EDI, 
les outils en ligne de commande, ObjectWindows et Turbo Debugger) ainsi 
que Win32s, qui vous permet d'executer des applications 32 bits sous 
Windows 16 bits. Ce programme d'installation fonctionne sous Windows, 
Win32s et Windows NT ; toutes les applications, cependant, ne tournent pas 
sous Windows NT. 

Pour de plus amples informations sur I'installation de Borland C++, 
consultez le fichier INSTALL.TXT, sur la premiere disquette (ce fichier 
n'etant pas compresse, il est lisible par tout editeur de texte). 

L'installation depuis disquettes ou depuis CD-ROM est sensiblement 
identique, mais nous vous recommandons de lire le fichier INSTALL.TXT 
ou les notes du CD si vous installez depuis un CD-ROM. 

Pour installer Borland C++ depuis les disquettes : 

1. Placez la premiere disquette dans le lecteur. 

2. Depuis Windows, choisissez Fichier I Executer dans le Gestionnaire de 
programmes. 
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3. Tapez a : \install (ou b : \install) et appuyez sur Entree. Uneboite 
de dialogue s'ouvre, dans laquelle s'affiche la quantite d'espace disque 
necessaire pour l'installation complete (Target Requirements), ainsi que 
l'espace disponible sur votre machine. Si vous utilisez la compression de 
fichiers, lisez le fichier INSTALL.TXT : il se peut que vous ayez besoin de 
plus de place que ce qui est signale comme disponible. 

4. Cliquez sur Customize BC4.0 Installation si vous desirez n'installer 
qu'une partie du package. Une seconde boite de dialogue s'ouvre alors, 
contenant une description des modules installables. Cliquez le bouton 
correspondant a la partie que vous souhaitez personnaliser. Dans la boite 
de dialogue qui s'affiche, vous pouvez cocher les fichiers qui vous 
interessent (par defaut, tous les fichiers sont copies sur le disque de 
destination). Cliquez sur OK et repetez cette operation pour tous les 
modules que vous souhaitez personnaliser. Cliquez sur OK pour revenir 
a la premiere boite de dialogue de l'installation. 

5. Les repertoires dans lesquels les fichiers vont etre copies s'affichent a 
l'ecran. Vous pouvez les modifier. 

■ Borland C++ destination directory est le repertoire principal, a partir 
duquel tous les fichiers seront copies (il s'agit, par defaut, de C:\BC4). 

■ Borland C++ Working directory est le repertoire dans lequel les 
applications de Borland C++ sont installees (C:\BC4\BIN). 

6. Par defaut, l'installation cree un groupe Windows dans lequel sont 
placees les icones de Borland C++. Si vous ne souhaitez pas creer ce 
groupe, deselectionnez l'option Create Borland C++ Group. 

7. Win32s est egalement installe par defaut. Deselectionnez cette option si 
vous ne souhaitez pas copier les fichiers correspondants sur votre disque 
dur. 

8. Ne cochez LAN Windows Configuration que si votre machine est 
equipee de LAN Windows. 

9. Cliquez sur Install pour lancer la copie. A la fin de l'installation, lisez le 
fichier README, qui contient des informations de derniere minute sur 
votre logiciel. Pour de plus amples informations sur les icones creees lors 
de l'installation, lisez le fichier INSTALL.TXT copie dans le repertoire 
C:\BC4. 

Verifiez que votre CONFIG.SYS contient au moins la valeur 40 pour les 
parametres FILES et BUFFERS. 
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La procedure d'installation modifie certains fichiers de votre disque dur : 

■ AUTOEXEC.BAT contient maintenant le parametre C:\BC4\BIN (ou 
toute autre repertoire specifie par vous) dans l'instruction PATH. 

■ WIN.INI contient une section [BCW4 . INSTALL] utilisee par TASM (si 
celui-ci est installe) pour savoir ou Borland C++ est place sur votre 
machine. De plus, dans la section [EXTENSIONS ] , l'extension EDI est 
associee a l'Environnement de Developpement Integre BCW.EXE. 

■ SYSTEM.INI contient les lignes suivantes : 

device = c:\bc4\bin\tddebug.386 
device = c:\bc4\bin\windpmi.386 

■ Si vous avez Windows NT, la section [BORLAND INSTALL] est inseree 
dans CONFIG.NT. 

Le fichier FILELIST.DOC liste tous les fichiers composant Borland C++. 
Lisez-le attentivement avant de supprimer certains fichiers pour liberer de 
l'espace disque. 



Lancement de 
Borland C++ 



f« 



Borland 
C++ 



Pour lancer l'EDI, faites un double-clic sur l'icone de Borland C++ (voir 
marge gauche) sous Windows. L'EDI vous permet de saisir, de modifier, de 
compiler, de linker (editer les liens), de deboguer et de gerer vos projets de 
developpement. II offre : 

■ Un editeur et un Browser, decrits dans le present chapitre 

■ Un gestionnaire de projets, decrit au chapitre 2 

■ Un debogueur, decrit au chapitre 6 

La figure 1.1 montre certains des modules de l'EDI. 
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Figure 1.1 
Modules de I'EDI 



Barre 
d'icones 

Fenetre 
editeur 



Fenetre 
projet 




TurboMenu 



Barre d'etat 

L'EDI integre des TurboMenus contextuels qui vous permettent de modifier 
rapidement les objets. Pour voir un TurboMenu, cliquez, avec le bouton 
droit, dans une fenetre (celle-ci doit avoir ete selectionnee avec le bouton 
gauche) ou sur un element d'une fenetre, ou appuyez sur Alt+F10 (le 
TurboMenu change en fonction de l'objet selectionne). Par exemple, pour 
passer rapidement a une ligne precise dans la fenetre d'edition, cliquez avec 
le bouton droit dans la fenetre d'edition, choisissez Go to line, puis entrez le 
numero de la ligne a atteindre. L'option de menu "Go to line" n'apparait que 
si une fenetre d'edition est selectionnee. Si vous ouvrez un TurboMenu dans 
une fenetre de projet, les menus qui s'afficheront seront totalement 
differents. 

La barre d'icones change aussi en fonction de la fenetre selectionnee. 
II existe une barre d'icones configurable pour l'editeur, le Browser, le 
debogueur, le gestionnaire de projets, la fenetre de messages, le bureau et le 
ClassExpert (voir la section "Modifications des barres d'icones", plus loin 
dans ce chapitre). Lorsque le pointeur est sur un bouton de la barre d'icones, 
une ligne decrivant ce bouton s'affiche dans la ligne d'etat de l'EDI. 

Certains des boutons de la barre d'icones sont parfois estompes. Ceci 
signifie que la commande correspondante n'est pas disponible dans le 
contexte courant. Par exemple, si une fenetre d'edition est ouverte, le bouton 
Coller le texte du Presse-papiers est estompe si le Presse-papiers ne contient 
aucun texte. 
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Comment activer L'Aide en ligne de Borland C++ contient des informations detaillees sur 

I'aide Borland C++. Par rapport au manuel, l'Aide en ligne traite des sujets 

supplementaires suivants : 

■ Les menus de l'EDI 

■ Le KEYMAPPER de l'editeur 

■ Exemple de code des bibliotheques run-time 

■ L'API Windows 

Pour activer l'Aide en ligne : 

■ Depuis l'EDI, choisissez Help dans la barre de menus ou appuyez sur F1. 

■ Dans les boites de dialogue, cliquez sur le bouton Help ou appuyez sur F1. 

■ Pour obtenir des informations sur une option de menu, selectionnez-la et 
appuyez sur F1. 

Configuration de l'EDI 



Pouretendreou 

condenser la liste des 

options, vous pouvez 

aussi appuyer sur + ou 

sur - (sur le pave 

numerique). 



Vous pouvez parametrer l'EDI de telle sorte qu'il effectue seul certaines 
taches (creer une sauvegarde des fichiers dans les fenetres d'edition, par 
exemple) ou qu'il gere des evenements. Cette section explique comment 
proceder. 

La boite de dialogue Environment Options permet de configurer l'editeur, le 
Browser, le debogueur, les fenetres de projets et d'autres elements de l'EDI 

(ces options sont enregistrees dans le fichier BCCONFIG.BCW). 

Pour afficher la boite de dialogue Environment Options, choisissez 
Options I Environment. La liste des sujets s'affiche a gauche de la boite de 
dialogue. Certains comprennent des sous-sujets (le sujet Editeur, par 
exemple, comporte les sous-sujets Options, File et Display). Lorsqu'un sujet 
comporte des sous-sujets qui ne sont pas affiches, le signe "+" est place en 
regard de son nom. Si vous cliquez dessus, les sous-sujets s'affichent et le 
signe "+" devient un "-" (si vous cliquez sur le "-", la liste des sous-sujets se 
retracte a nouveau). Les sujets n'ayant pas de sous-sujets sont precedes d'un 
point. Lorsque vous cliquez sur un sujet, ses caracteristiques s'affichent a 
droite de la boite de dialogue. 

Ce chapitre ne detaille pas toutes les sujets de la boite de dialogue Options I 
Environment. Reportez-vous a l'Aide en ligne pour de plus amples 
informations sur les sujets et les options. 
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Certains sujets associes a des taches ou des modules de l'EDI sont decrits 
plus loin dans ce manuel (les options de projet, par exemple, sont decrites 
au chapitre 2). Consultez l'index en fin d'ouvrage pour localiser les 
informations specifiques aux sujets. 



Modification des II existe une barre d'icones configurable pour l'editeur, le Browser, le 

barres d'icones debogueur, le gestionnaire de projets, la fenetre de messages, le bureau et le 

ClassExpert. Lorsque vous selectionnez l'une de ces fenetres, la barre 
d'icones correspondante s'affiche. Toutes ces barre d'iconess sont 
configurables : vous pouvez ne leur attribuer que les boutons dont vous 
vous servez le plus souvent. 

Pour ajouter ou supprimer des boutons dans une barre d'icones : 

1. Choisissez Options I Environment dans le menu principal. 

2. Choisissez le sujet barre d'icones a gauche. La partie droite de la boite de 
dialogue liste les options generales de toutes les barre d'iconess. 

Ces options vous permettent de modifier la position de la barre d'icones 
(en haut ou en bas de l'EDI) et son mode d'utilisation (cochez Use flyby 
help pour que les lignes d'aide s'affichent dans la ligne d'etat lorsque 
vous placez le pointeur sur un bouton). 

3. Choisissez Customize, le sujet sous barre d'icones. Les options a droite 
contiennent des informations sur les barre d'iconess. 

4. Choisissez le type de barre d'icones a modifier (Editeur, Browser, 
Debugger, Project, Message, Desktop ou classex) dans la liste deroulante 
Window. 

La colonne de gauche (Available Buttons) vous presente les boutons 
disponibles (non utilises) et leur description. La colonne de droite (Active 
Buttons) ne presente que les boutons de la barre d'icones selectionnee. 

5. Pour ajouter un bouton, faites un double-clic sur son icone dans la liste 
Available Buttons ou selectionnez-le et cliquez sur la fleche orientee vers 
la droite. Le bouton passe dans la liste Active Buttons. 

6. Pour supprimer un bouton, faites un double-clic sur son icone dans la 
liste Active Buttons ou selectionnez-le et cliquez sur la fleche orientee 
vers la gauche. Le bouton passe dans la liste Available Buttons. 

Pour changer l'ordre des boutons d'une barre d'icones, utilisez les fleches 
haute et basse. Le bouton selectionne dans la liste Active Buttons se deplace 
vers le haut ou vers le bas (le bouton du haut est place a gauche de la barre 
d'icones, et le dernier est place a droite). 
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Choix de 
preferences de 
I'EDI 



Enregistrement 
des parametres de 
I'EDI 



Pour donner le meme aspect a toutes vos barre d'iconess, selectionnez une 
barre d'icones dans la liste Window puis cliquez sur Copy Layout. Une boite 
de dialogue s'ouvre, dans laquelle vous cochez toutes les barre d'iconess 
auxquelles vous desirez donner l'aspect de la barre d'icones selectionnee. 

Pour redonner son aspect par defaut a une barre d'icones, selectionnez-la 
dans la liste Window et cliquez sur Restore Layout. 

Les separateurs placent un espace entre deux boutons. Pour placer des 
separateurs dans une barre d'icones, selectionnez un bouton dans la liste 
Active Buttons et cliquez sur Separator. Le separateur s'insere devant le 
bouton selectionne. 

Les preferences vous permettent de definir precisement ce que vous voulez 
enregistrer de facon automatique, et de specifier le mode de fonctionnement 
de certaines fenetres. 

Pour definir vos preferences, 

1. Choisissez Options I Environment I Preferences. 

2. Cochez les options de votre choix. Chacune est decrite dans l'Aide en 
ligne. 

3. Cliquez sur OK. 

Lorsque vous quittez I'EDI, generez un projet, utilisez un outil de transfert, 
lancez le debogueur integre, ouvrez, fermez ou enregistrez un projet, 
certaines informations sont automatiquement enregistrees sur disque. II est 
possible de parametrer cette fonctionnalite en choisissant Preferences dans 
la boite de dialogue Environment Options (qui s'affiche lorsque vous 
choisissez Options I Environment dans le menu principal). 

Pour enregistrer manuellement votre environnement de travail : 

1. Choisissez Options I Save. 

2. Cochez Environment pour enregistrer les parametres de l'Editeur, de la 
Mise en surbrillance de la syntaxe, des barre d'iconess, du Browser et de 
vos Preferences definies dans la boite de dialogue Environment Options. 
L' enregistrement se fait dans le fichier BCCONFIG.BCW. 
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3. Cochez Desktop pour enregistrer les informations concernant les 
fenetres ouvertes et leur position. Ces donnees sont stockees dans le 
fichier <projet>.DSW. Si aucun projet n'est ouvert, elles sont stockees 
dans BCWDEF.DSW. 

4. Cochez Project pour enregistrer les modifications apportees au fichier du 
projet (.IDE), notamment les options de "build" et les attributs de noeuds. 



Utilisation de I'Editeur 



Vous pouvez ouvrir 32 

fenetres d'edition 

simultanement dans 

I'EDI. 



Les fenetres d'edition servent a creer et a editor le code source de vos 
programmes. Lorsque vous editez un fichier, la barre d'etat de l'EDI affiche 
le numero de la ligne et de la colonne sur lesquelles se trouve le curseur (1 :1 
ou 68 :23, par exemple). La barre d'etat indique aussi si le curseur est en 
mode Insertion ou en mode Surfrappe (appuyez sur Inser pour passer d'un 
mode a l'autre). De plus, si vous avez modifie le fichier affiche, le mot 
Modified vient se placer dans la barre d'etat. 

L'Editeur vous permet d'annuler les dernieres modifications en choisissant 
Edit I Undo ou en appuyant sur Alt+Retour arriere. Si, par exemple, vous 
effacez une ligne puis en collez une autre, vous pouvez annuler ces deux 
operations : Taction de coller la ligne est annulee en premier, puis 
l'effacement de la ligne initiale. Pour specifier le nombre d'operations 
pouvant etre annulees, choisissez Options I Environment I Editor I 
Options. 



Configuration de 
I'editeur de I'EDI 



Lesfichiers .CKB 

configurent aussi les 

autres fenetres de 

I'EDI. Voir I'Aide en 

ligne pour de plus 
amples informations. 



Vous pouvez configurer I'editeur de telle facon qu'il emule d'autres editeurs 
de texte (Brief ou Epsilon, par exemple). L'editeur de l'EDI utilise des 
fichiers de mappe du clavier (.CKB) qui definissent les raccourcis clavier de 
I'editeur (ces fichiers modifient egalement les raccourcis clavier des autres 
fenetres). 

Pour utiliser l'un des quatre fichiers .CKB, choisissez Options I 
Environment I Editor et cliquez sur un SpeedSetting (Default keymapping, 
EDI classic, BRIEF emulation ou Epsilon). Pour de plus amples informations 
sur la creation de vos propres fichiers .CKB, voir I'Aide en ligne (mot cle 
"Keymapper"). 
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Mise en La mise en surbrillance de la syntaxe vous permet de definir une couleur et 

surbrillance de la un attribut de caractere (gras, par exemple) pour certaines parties de votre 

syntaxe code. Ceci permet, par exemple, d'afficher les commentaires en bleu et les 

chaines en rouge. Par defaut, la mise en surbrillance est activee. 

Pour la desactiver : 

1. Choisissez Options I Environment I Syntax Highlighting. 

2. Deselectionnez Use Syntax Highlighting. 

La mise en surbrillance fonctionne pour les fichiers dont l'extension figure 
dans la liste Syntax Extensions (.CPP, .C, .H et .HPP par defaut). Vous 
pouvez supprimer ou ajouter des extensions dans cette liste, mais vous 
devez les separer par un point-virgule. 

La section Syntax Highlighting affiche les couleurs par defaut ainsi que 
quatre jeux de couleurs predefinis (des boutons). 

Pour utiliser des couleurs predefinies : 

1. Choisissez Options I Environment I Syntax Highlighting. 

2. Choisissez l'un des quatre jeux de couleurs en cliquant sur le bouton 
correspondant. A partir de ces jeux predefinis, vous pouvez creer vos 
propres associations de couleurs pour la mise en surbrillance de la 
syntaxe. 

Pour selectionner manuellement les couleurs de mise en surbrillance : 

1. Choisissez Options I Environment I Syntax Highlighting I Customize. 
Des elements et un listing type s'affichent en haut a droite de la boite de 
dialogue Environment Options. 

2. Selectionnez l'element a modifier dans la liste ou cliquez sur l'element en 
question dans l'exemple de code (que vous pouvez faire defiler). 
L'exemple utilise la police selectionnee dans la section Editor I Display 
section de la boite de dialogue Environment Options. 

3. Selectionnez une couleur pour cet element. Utilisez le bouton gauche de 
la souris pour selectionner la couleur du premier plan (FG - 
"Foreground" - s'inscrit dans la couleur). Utilisez le bouton droit pour 
selectionner la couleur d'arriere-plan (BG - "Background" - s'inscrit). Si 
FB s'inscrit dans la couleur, cela signifie que la couleur est utilisee a la 
fois dans le premier plan et dans l'arriere-plan. 

4. Choisissez un attribut, gras par exemple. 
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5. Vous pouvez cocher Default FG (premier plan) ou BG (arriere-plan) pour 
utiliser les couleurs par defaut de Windows pour un element. 

6. Repetez les etapes 2, 3 et 4 pour tous les elements a modifier. 



La fenetre de messages 



Vous pouvez 

personnaliser certaines 

des fonctionnalites des 

fenetres de messages 

en utilisant la section 

Preferences de la boite 

de dialogue 

Environment Options. 



La fenetre de messages affiche les erreurs et des avertissements lorsque vous 
compilez vos programmes. Lorsque vous selectionnez un message dans la 
fenetre de messages, l'editeur place le curseur a l'endroit de votre code qui a 
genere ce message. Si le fichier contenant l'erreur n'est pas en memoire, 
appuyez sur la Bane d'espacement pour le charger (vous pouvez aussi 
appuyer sur Alt+FW et choisir View source dans le TurboMenu). La fenetre 
de messages reste active pour que vous puissiez passer de message en 
message. 

Pour voir le code associe a une erreur ou a un avertissement, selectionnez le 
message dans la fenetre de messages et appuyez sur Entree, double-cliquez 
sur le message, ou appuyez sur Alt+F10 et choisissez Edit source dans le 
TurboMenu. Le curseur se place sur le source qui a genere l'erreur (la 
fenetre de messages passe a l'arriere-plan). Utilisez AW+F7 pour voir le 
message d'erreur suivant, AH+F8 pour voir le precedent. 

Vous pouvez aussi vous deplacer dans les messages dans la fenetre de 
messages. Lorsque vous selectionnez un message, le curseur de la fenetre 
d'edition se place automatiquement sur le code fautif (ceci s'appelle la 
recherche automatique d'erreur). La recherche automatique d'erreur ne 
fonctionne que si le fichier en question est ouvert dans une fenetre d'edition. 
Si le message suivant concerne un fichier source autre que celui qui est dans 
la fenetre d'edition active, vous devez selectionner la fenetre d'edition en 
question pour poursuivre la recherche automatique d'erreur. 

Vous pouvez effacer la fenetre de messages en choisissant Remove all 
messages dans le TurboMenu (cliquez avec le bouton droit ou appuyez sur 
Alt+F10 pour afficher le TurboMenu). 
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Parcourir votre code 



Le Browser permet de visualiser la hierarchie de vos objets, classes, 
fonctions, variables, types et constantes de votre programme. II vous permet 
aussi de : 

■ Afficher sous forme graphique les hierarchies de votre application, puis de 
selectionner un objet et voir les fonctions et symboles qu'il contient et dont 
il herite. 

■ Lister les variables de votre programme, de les selectionner et de voir leur 
declaration, de lister leurs references au sein du programme, ou d'editer 
leur declaration dans le code source. 

Avant d'utiliser le Browser, definissez ces options dans la boite de dialogue 
Project Options (choisissez Options I Project) et compilez votre application : 

■ Choisissez Compiler I Debugging et cochez Debug information in OBJs 

■ Choisissez Compiler I Debugging et cochez Browser reference 
information in OBJs 

■ Choisissez Linker I General et cochez Include debug information. 



Le Browser possede 

une barre dlcones 

personnalisable (voir 

plus haut la section 

"Modifications des 

barres d'icones" pour 

de plus amples 

informations). 



Pour lancer le Browser, choisissez Search I Browse Symbol, View I Classes, 
ou View I Globals. Vous pouvez aussi placer le curseur sur un symbole 
dans le code et choisir Search I Browse symbol. Si le programme dans la 
fenetre d'edition active n'a pas ete compile, vous devez le compiler et le 
linker avec les informations de debogage. Si vous tentez de visualiser, avec 
le Browser, une definition de classe (ou tout symbole ne possedant pas 
d'informations symboliques de debogage), un message d'erreur s'affiche. 

Vous pouvez definir des options du Browser dans la boite de dialogue 
Environment Options. Choisissez Options I Environment, cliquez sur 
Browser et selectionnez des options. Single window signifie que vous ne 
pouvez ouvrir qu'une fenetre de Browser a la fois ; Multiple windows ouvre 
une fenetre de Browser a chaque fois que vous effectuez une action liee au 
Browser (si vous choisissez View I Globals dans le menu principal, par 
exemple). Les symboles visibles sont decrits a la section "Emplacement dans 
les symboles globaux plus loin dans ce chapitres. 
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Visualisation des Choisissez View I Classes pour "prendre du recul" et voir les hierarchies des 

objets (vue objets de votre application, ainsi que les moindres details. Lorsque vous 

generale sur les choisissez View I Classes, le Browser dessine vos objets et montre leur 

classes) relation ancetre-descendant dans une arborescence horizontale. Les traits 

rouges vous aident a visualiser la relation ancetre-descendant immediate de 
l'objet selectionne. La figure 1.2 montre la structure de l'application 
WHELLO. 



Figure 1 .2 
Affichage des 
classes d'une 

application 
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Vous pouvez cocher 

des options du Browser 

dans la boite de 

dialogue Environment 

Options pour 

selectionner un type de 

symboles, mais vous 

devez definir ses 

options avant d'ouvrir 

des fenetres du 

Browser. 
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Pour en savoir plus sur un objet, double-cliquez dessus ou appuyez sur 
Entree apres l'avoir selectionne. 

Lorsque vous visualisez un symbole, les lettres qui l'identifient apparaissent 
dans la matrice Filters, au bas de la fenetre du Browser. Vous pouvez vous 
servir de ces filtres pour selectionner le type des symboles a visualiser (voir 
le tableau 1.1 pour de plus amples informations sur ces codes). 

La matrice des filtres compte une colonne pour chaque lettre. Cliquez sur la 
ligne du haut ou du bas pour deplacer la lettre. Une lettre dans la ligne du 
haut signifie que le Browser doit afficher les symboles ayant cet 
identificateur ; une lettre dans la ligne du bas signifie que le Browser doit 
ignorer les symboles ayant cet identificateur). 

Pour ne pas afficher certains types de symboles, cliquez sur la cellule 
inferieure de la colonne de la lettre (voir marge gauche). Ainsi, pour ne pas 
visualiser les variables de l'objet selectionne, cliquez sur la derniere cellule 
de la colonne V. 

Parfois, plusieurs lettres s'affichent a cote d'un symbole. La seconde lettre, 
placee juste apres la lettre identifiant le type du symbole, complete sa 
description. Voir le tableau 1.1 pour connaitre la liste des identificateurs. 
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Affichage des 
declarations des 
symboles listes 



II existe plusieurs methodes pour voir la declaration d'un symbole affiche 
dans une liste : 

■ Double-cliquez sur un symbole. 

■ Selectionnez un symbole et appuyez sur Entree. 

■ Selectionnez un symbole, appuyez sur Alt+F10 pour ouvrir le TurboMenu, 
puis choisissez Browse Symbol. 

La declaration s'affiche dans une fenetre, comme le montre la figure 1.3. 



Figure 1 .3 

Fenetre de 

declaration de 

symbole 



Browsing Main::hlnstance 



Browsing: struct HIN5TANCE *Main::hlnstance 



ml unused 



Filters: VuHZp 



Deplacement dans 
les symboles 
globaux 



Choisissez View I Globals pour ouvrir une fenetre listant tous les symboles 
globaux de votre application, tries par ordre alphabetique. Le Browser liste 
les symboles (fonctions, variables, etc.) utilises dans l'objet. La figure 1.4 
montre les symboles globaux de WHELLO. 



Figure 1 .4 

Affichage des 

symboles globaux 



Browsing Globals 



Browsing: Application 



□ 

QBEGINPAINT 

UBOOL 

U BYTE 

QCOLORREF 

yCREATESTRUCT 

QCREATEWINDOW 

QDEFWINDOWPROC 

QDISPATCHMESSAGE 

H DWORD 



Search 



Filters: 



xFFPF P 
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Une ou plusieurs lettres, symbolisant le type de l'objet, s'affichent a gauche 
des symboles de l'objet. Pour exclure certains symboles, servez-vous de la 
liste des filtres au bas de la fenetre du Browser. Voir la section precedente, 
"Filtres", pour de plus amples informations. 



Tableau 1.1 

Symboles litteraux 

du Browser 



Vous pouvez aussi 

entrer des expressions 

regulieres pour 

effectuer une recherche 

(?, * et +, par exemple). 



Litteral 

F 
T 
V 
C 

9 



Symbole 

Fonctions 

Types 

Variables 

Constantes integrates 

Debogable 

Herite d'un ancetre 

Methode virtuelle 



Pour de plus amples informations sur un symbole, cliquez dessus ou utilisez 
les touches flechees pour le selectionner. Une zone de critere, au bas de la 
fenetre, vous permet de taper les premieres lettres du nom du symbole pour 
une recherche rapide. Pour voir la declaration, selectionnez le symbole et 
appuyez sur Entree. Voir la section precedente pour de plus amples 
informations. 



Utilisation des 
expressions 
regulieres dans le 
Browser 



Vous pouvez utiliser des expressions dans la case de recherche de certaines 
fenetres du Browser. Le tableau 1.2 contient la liste des symboles autorises. 



Tableau 1.2 

Expressions de 

recherche du 

Browser 



Caractere Fonction 

Egal a un caractere, quel qu'il soit. 
* Egal a aucun ou plusieurs caracteres precedents. Par exemple : 

* est incorrect car aucun caractere ne precede *. 
ere * trouve tout texte commengant par "cr". 
cre*e trouve "ere", "cree'V'creee" 
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Tableau 1.2 

Expressions de 

recherche du 

Browser 

(suite) 



Caractere 



Fonction 



Egal a un ou plusieurs caracteres precedents. Par exemple : 

+ est une erreur 

cre+ trouve tout ce qui commence par "ere" 

cre+e trouve "cree" et "creee" 

Egal a aucun ou un caractere precedent. Par exemple : 

? est une erreur 

ere ? trouve tout texte commengant par "cr" 

cre?e trouve seulement "cree" ou "ere" 



Visualisation des 
symboles dans 
votre code 



Vous pouvez visualiser tout symbole dans votre code sans visualiser les 
hierarchies des objets ou les listes de symboles. Choisissez l'une des 
methodes ci-dessous : 

■ Mettez en surbrillance le symbole dans votre code et choisissez Search I 
Browse Symbol. 

■ Cliquez sur le bouton droit ou appuyez sur Alt+F10 lorsqu'une fenetre 
d'edition est selectionnee pour afficher le TurboMenu, puis choisissez 
Browse Symbol. 



Utilisation des outils en ligne de commande 



Borland C++ contient plusieurs outils en ligne de commande vous 
permettant de faire la meme chose que depuis l'EDI. Borland C++ inclut un 
compilateur, un editeur de liens, un compilateur de ressources, un 
bibliothecaire, un generateur de projets (appele MAKE), et d'autres outils en 
ligne de commande. La plupart de ces outils sont decrits dans ce manuel. 
Certains le sont dans les fichiers en ligne. Tous le sont dans l'Aide en ligne. 

Vous devez utiliser les outils en ligne de commande si vous travaillez avec 
un editeur DOS (Brief, par exemple). Void la liste des outils en ligne de 
commande, ce qu'ils font et ou en trouver une description complete : 

■ BCC.EXE et BCC32.EXE sont les compilateurs 16 bits et 32 bits. lis sont 
decrits au chapitre 3. 

■ TLINK.EXE et TLINK32.EXE lient les fichiers .OBJ et .LIB pour creer des 
fichiers .EXE et .DLL. lis sont decrits au chapitre 9. 
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DPMI et les outils 

enlignede 

commande 



■ IMPLIB.EXE et TLIB.EXE vous assistent dans la creation et l'utilisation des 
bibliotheques. lis sont decrits au chapitre 11. 

■ HC31.EXE compile les fichiers de l'Aide en ligne et cree le fichier .HLP au 
format standard de l'aide sous Windows. II est decrit dans l'Aide en ligne. 

■ BRCC.EXE, BRCC32.EXE, BRC.EXE, BRC32.EXE et RLrNK.EXE sont des 
outils de compilation des ressources de vos applications. lis sont decrits au 
chapitre 10. 

■ MAKE. EXE et MAKER.EXE vous assistent dans la gestion de vos projets 
en ne generant que les fichiers qui ont ete modifies depuis le precedent 
"build". lis sont decrits au chapitre 12. 

Le compilateur en ligne de commande utilise DPMI (Dos Protected Mode 
Interface) pour s'executer en mode protege sur les machines 286, 386, i486 
ou Pentium ayant au moins 640 ko de memoire conventionnelle et 1 Mo de 
memoire etendue. 

Bien que Borland C++ s'execute en mode protege, il genere des applications 
capables de s'executer en mode reel. L'avantage du mode protege est qu'il 
laisse plus de place en memoire au compilateur Borland C++, ce qui vous 
permet de compiler de gros projets sans echange sur disque. 



Memoire vive et 
MAKESWAP.EXE 



MAKESWAP ne 

fonctionne que pour les 

sessions DOS 

standards, non 

executees dans une 

fenetre Windows. 

Consultez le fichier 

INSTALL.TXT pour de 

plus amples 

informations. 



Si vous recevez des messages "Memoire insuffisante" sous DOS (DOS 
n'etant pas execute depuis Windows) lorsque vous executez les outils 32 bits 
en ligne de commande, creez un fichier d'echange avec l'utilitaire 
MAKESWAP, en indiquant la taille desiree en ko : 

MAKESWAP 12 00 

cree un fichier d'echange de 12 Mo du nom de EDPMI.SWP dans le 
repertoire courant, auquel les outils en ligne de commande accedent s'ils 
manquent de memoire vive. Pour parametrer un fichier d'echange, utilisez 
la variable d'environnement DPMIMEM a l'invite du DOS, ou inserez la 
ligne suivante dans votre AUTOEXEC.BAT : 

set DPMIMEM=SWAPFILE Emplacement du f ichier>\EDPMI . SWP 

Vous devez supprimer cette variable d'environnement avant d'utiliser les 
outils en ligne de commande de Borland C++ 3.1 ou d'autres executables 16 
bits en mode DPMI (Paradox, par exemple). Entrez la commande suivante a 
l'invite du DOS : 



set DPMIMEM= 
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Gestionnaire de 
run-times et outils 
enlignede 
commande 



Les applications Borland C++ en mode protege (telles que BCC et BCC32) 
utilise le gestionnaire de run-times RTM.EXE et 32RTM.EXE. Les outils qui 
utilisent le gestionnaires de run-times chargent d'abord le gestionnaire, 
accomplissent leur tache puis le dechargent de la memoire. Si vous faites de 
nombreux appels aux outils 32 bits en ligne de commande utilisant le 
gestionnaire de run-times (depuis un fichier MAKE, par exemple), vous 
pouvez gagner du temps en chargeant le gestionnaire de run-times une fois 
puis en appelant les outils. Pour charger le gestionnaire, tapez 32RTM 
depuis la ligne de commande. Pour le decharger, tapez 32RTM -u. 



Controle de la 
memoire utilisee 
par le gestionnaire 
de run-times 



Par defaut, le gestionnaire de run-times utilise toute la memoire lorsqu'il se 
charge, puis l'alloue a ses clients lorsqu'ils la demandent par le biais des 
routines API du gestionnaire de memoire. 

Pour indiquer la memoire utilisable par le gestionnaire de run-times, tapez 
la commande suivante a l'invite de DOS : 

SET RTM= [option nnnn] 

Le tableau ci-dessous liste les options utilisables. Le parametre "nnnn" peut 
etre une valeur decimale ou hexadecimale au format xAB54 ou xab54. 



Tableau 1 .3 

Variables 

d'environnement 

controlant 

I'allocation memoire 

deRTM 



Option 



Description 



EXTLEAVE nnnn Toujours laisser au moins nnnn ko de memoire etendue disponible. La 
valeur par defaut est 640 ko. 

EXTMAX nnnn Ne pas allouer plus de nnnn ko de memoire etendue. La valeur par defaut 
est 4 Go. Sous Windows, la valeur par defaut est la moitie de la memoire 
disponible. 

EXTMIN nnnn Si moins de nnnn ko sont disponibles apres application de EXTMAX et de 

EXTLEAVE, quitter I'application et afficher le message "Memoire 
insuffisante". La valeur par defaut est zero. 

REALLEAVE nnnn Toujours laisser au moins nnnn paragraphes de memoire reelle disponible. 
La valeur par defaut est 64 ko (4096 paragraphes). 

REALMAX nnnn Ne pas allouer plus de nnnn paragraphes de memoire reelle. La valeur par 
defaut est 1 Mo (65535 paragraphes). 

REALMIN nnnn Si moins de nnnn paragraphes sont disponibles 

apres application de REALMAX et de REALLEAVE, 
quitter I'application et afficher le message 
"Memoire insuffisante". La valeur par defaut 
est zero. 
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Lancement d'autres programmes depuis I'EDI 



Vous pouvez lancer des programmes, outils et utilitaires externes (Turbo 
Debugger, Resource Workshop, GREP, WinSight, WinSpector et 
Keymapper) sans quitter l'EDI. Pour ce faire, choisissez Tools I Nom du 
programme (par exemple, Tools I GREP). 

Pour placer des programmes dans le menu Tools : 

1. Choisissez Options I Tools. La boite de dialogue Tools s'affiche ; elle 
vous montre les Outils, les Visualiseurs et les Traducteurs. 

2. Cliquez sur New. Pour ajouter un outil existant (liste dans la boite de 
dialogue Tools), cliquez sur Edit. 

3. Entrez le nom du programme, son chemin d'acces et toute option de 
ligne de commande necessaire. Vous pouvez utiliser les macros de 
transfert sur cette ligne de commande. Voir l'Aide en ligne pour de plus 
amples informations. 

4. Entrez le texte du menu, qui pourra s'afficher dans les TurboMenus et 
dans le menu principal Tools. Si vous desirez associer un raccourci 
clavier a cette option, faites preceder l'une des lettres du signe "&" ; elle 
apparaitra ainsi soulignee dans le menu. Par exemple, si le raccourci de 
l'option Fichier est F, elle apparait sous la forme &Fichier. Pour 
afficher un signe perluete, entrez-le en deux ; ainsi, & & Test deviendrait 
&Test dans le menu final. 

5. Entrez un eventuel texte d'aide, qui s'affichera dans la ligne d'etat 
lorsque l'option sera selectionnee. 

6. Cliquez sur Advanced. La boite de dialogue Tool Advanced Options 
s'ouvre. 

7. Cochez Translator si le programme utilise un type de fichier pour en 
creer un autre (ce que fait un compilateur, par exemple). Cochez Viewer 
si le programme permet de visualiser un fichier (un editeur, par 
exemple). 

8. Cochez Place on Tools menu. Cochez Place on SpeedMenu pour que le 
programme apparaisse dans le TurboMenu de la fenetre du projet (voir 
le chapitre 2 pour de plus amples informations sur les projets). 

9. Si votre programme est un Traducteur, entrez l'extension des fichiers 
qu'il peut traiter (BCC traduit les fichiers .C et .CPP, . Par exemple). 
Utilisez le point-virgule pour separer chaque extension, et placez le 
caractere ":" a la fin de la liste. 
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10. Entrez l'extension du fichier genere par le traducteur (".OBJ", par 
exemple). 

11. Cliquez sur OK dans toutes les boites de dialogue ouvertes. 

12. Choisissez Tool dans le menu principal pour verifier que votre 
programme a bien ete ajoute. 
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Utilisation du gestionnaire de projet 



Borland C++ Version 4.0 integre un nouveau gestionnaire de projet aux 
fonctionnalites etendues. Ce chapitre explique comment utiliser 
Borland C++ pour creer des applications et des projets a partir de vos 
fichiers source et comment utiliser les fichiers .PRJ des versions precedentes 
du gestionnaire de projet. Si vous utilisiez deja une version anterieure du 
gestionnaire de projet, lisez attentivement ce chapitre. 

Le gestionnaire de projet sait traiter des applications issues de composants 
divers et varies. Les applications peuvent contenir plusieurs modules source 
modules qui doivent etre compiles avec des options differentes. Par 
exemple, pour creer un .EXE, les scripts de ressources doivent etre compiles 
avec le compilateur de ressources, des bibliotheques d'import doivent etre 
creees et les fichiers .OBJ doivent etre lies avec l'editeur de liens. 



Qu'est-ce que la gestion de projets ? 



Le gestionnaire de 

projet lit les fichiers 

PRJ des versions 

precedentes. 



II structure et met a jour des applications complexes en consignant le nom 
de tous les fichiers et leur interdependance dans un fichier projet ayant 
l'extension .IDE. 

L'utilisation du gestionnaire de projet est une facon efficace de creer des 
projets car il ne traduit que les fichiers qui ont ete modifies depuis la 
derniere creation du projet. Le terme traduire designe la lecture d'un fichier 
dans un format specifique et son ecriture dans un format different. Par 
exemple, le compilateur C++ est un traducteur de fichiers .CPP car il les 
utilise pour generer des fichier .OBJ (voir en fin de chapitre la section 
traitant des traducteurs pour de plus amp les informations). 

Un projet peut etre considere comme un ensemble de fichiers dependant les 
uns des autres. Certains fichiers contiennent du code source que vous creez ; 
d'autres, tels que les fichiers .OBJ, .EXE ou .DLL, sont generes par le 
compilateur, l'editeur de liens ou d'autres outils dependant de vos fichiers 
de code source. 
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Figure 2.1 

Arborescence de 

projet 



Dans le gestionnaire de projet, les dependances sont indiquees de facon 
graphique : il s'agit de l'arborescence de projet. A chaque niveau, les fichiers 
montres dans un projet sont dependants des fichiers places en retrait en 
dessous d'eux, comme le montre la figure 2.1. 



Noeud de projet 
Noeud cible 

Noeud- 



Noeud- 
d'execution 



Project: c:\bc4\bin\sample.ide 

sample [.ide] <MakeNode> 



-'— H sample [.exe] <LinkTarget> 

-Q cOwl [.obj] <Binl ncludo 

■Q sample [.cpp] <CppCompile> 

-Q sample [.re] <CompileResources> 

-fj) sample [.def] < Sour eel ncludo 

-Q bidsi [.lib] <Binlnclude> 

— D owlwi [.lib] <Binlnclude> 

— D import [.lib] <Binl ncludo 
-Q crtldll [.lib] <Binlnclude> 



Dans l'arborescence de projet, chaque noeud est represente par une icone 
differente. 

■ Un noeud de projet represente l'integralite du projet. Tous les fichiers 
servant a creer ce projet sont places en dessous (un noeud de projet est 
similaire a une cible symbolique dans un fichier MAKE). Un projet peut 
contenir de nombreux noeuds cibles. Vous pouvez, par exemple, avoir un 
projet que vous utilisez pour creer deux applications et une DLL (trois 
cibles). 

■ Un noeud cible represente un fichier qui est genere lorsque ses noeuds 
dependants sont crees (une cible est generalement le fichier .EXE ou .DLL 
que vous generez a partir de votre code source). Vous pouvez condenser 
un noeud cible pour que les noeuds qui en dependent ne soient pas 
affiches. 

■ Un noeud designe generalement un fichier servant a generer une cible, tel 
que les fichiers .C, .CPP, .H et .RC. 

■ Un noeud d'execution ("runtime") designe les fichiers communs utilises 
lors de l'execution, tels que du code de demarrage (les fichiers .LIB). II est 
possible de ne pas afficher ces fichier (voir la section "Modification de la 
visualisation du projet", plus loin dans ce chapitre). 
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Construction d'un projet 



Pour creer un projet : 

1. Choisissez Project I New project. Entrez le chemin d'acces et le nom du 
projet (huit caracteres au plus), puis appuyez sur Tab. Vous pouvez aussi 
utiliser le bouton Browse pour selectionner le fichier du projet. 

2. Entrez le nom de la premiere cible de votre projet. II s'agit generalement 
du nom du programme a creer (le fichier .EXE ou .DLL). 

Vous pouvez utiliser 3. Choisissez un type de cible : 

JZSSlZ ■ Application est un fichier .EXE normal. 

■ Dynamic Library est un fichier .DLL. 

■ EasyWin est une application en mode caractere qui s'execute sous 
Windows. 

■ Static Library est un fichier .LIB. 

■ Import Library est un fichier .LIB. 

■ Windows Help est un fichier d'aide (.HLP) qui s'active depuis une 
application Windows (.EXE). 

4. Choisissez une plate-forme pour votre cible : 

■ Windows 3.x est une application Windows 16 bits. 

■ Win32 est une application 32 bits Windows NT. 

■ DOS Standard est une application DOS 16 bits. 

■ DOS Overlay est une application DOS 16 bits utilisant les fichiers de 
recouvrement ("overlays"). 

5. Cochez les bibliotheques que vous souhaitez utiliser dans votre 
application. Certaines sont cochees par defaut lorsque vous selectionnez 
un type de cible (vous ne pouvez alors pas deselectionner certaines, car 
elles sont indispensables a la creation de votre cible). Si des bibliotheques 
dynamiques et statiques existent, vous pouvez specifier lesquelles vous 
allez utiliser (les bibliotheques dynamiques sont en general selectionnees 
par defaut). 

■ OWL utilise les bibliotheques ObjectWindows. Voir le Guide du 
programmeur Object Windows pour de plus amples informations. 

■ Class Library utilise les bibliotheques Borland de classes de conteneur, 
decrites dans le guide du programmeur. 
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Voir le Guide de 

reference DOS pour de 

plus amples 

informations sur ces 

bibliotheques. 



■ Runtime utilise les bibliotheques d'execution ("run-time") listees dans 
le Guide de reference. 

■ BWCC utilise les bibliotheques de controle personnalisees Windows de 
Borland. Voir l'annexe B. 

■ BGI utilise l'lnterface Graphique de Borland (uniquement disponible 
pour les applications DOS). Voir les fichier UTILS.TXT. 

6. Cochez Diagnostic si vous desirez utiliser la version de diagnostic des 
bibliotheques (disponible pour les Class Libraries et ObjectWindows ; 
voir la documentation ObjectWindows pour de plus amples 
informations). 

7. Cochez Multithread si vous desirez utiliser la version multithread de la 
bibliotheque run-time. Cette option n'est disponible que si vous avez 
choisi la plate-forme Win32. 

8. Si votre application est pour DOS, cochez 

■ Floating point pour editer les liens dans FP87.1ib. 

■ Emulation pour editer les liens dans EMU.LIB. 

■ No Math pour editer les liens dans les bibliotheques mathematiques 
DOS. 

9. Choisissez un modele de memoire pour votre cible (Target Model). Les 
modeles changent en fonction de votre type de cible. 

10. Cliquez sur OK pour creer le projet. Une representation graphique 
s'affiche dans une fenetre d'edition. Pour modifier les attributs de la 
cible, definis aux etapes 2 a 8, utilisez le TurboMenu du gestionnaire de 
projet (cliquez, avec le bouton droit, sur un noeud ou appuyez sur 
M+F10). 

Le gestionnaire de projet cree une cible avec une ou plusieurs dependances - 
les dependances par defaut varient en fonction de la cible. Pour voir quels 
dependances sont ajoutees, cliquez sur le bouton Advanced dans la boite de 
dialogue New Project. Vous pouvez selectionner d'autres noeuds et cliquer 
sur OK. En cas d'application DOS, il est possible d'indiquer le 
fonctionnement souhaite des segments de pile et de donnees. 

Apres avoir cree la cible initiale du projet, vous pouvez ajouter, supprimer 
ou reorganiser ses noeuds et ses cibles. Pour plus de details, voir la section 
"Modification de l'arborescence du projet" plus loin dans ce chapitre. 
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Creation d'un 
projet multi-cible 



Pour inclure une DLL 

pour une application, 

placez le noeud de la 

DLL sous lenoeud 

.EXE. 



Conversion des 
anciens projets 



La creation de projets multi-cibles est similaire a la creation de projets a une 
seule cible : 

1. Creez votre projet comme decrit a la section "Creation d'un projet", au 
debut de ce chapitre. 

2. Choisissez Project I New target pour ajouter une seconde cible a votre 
application. La boite de dialogue New Target s'affiche. 

3. Entrez le nom de la seconde cible et choisissez son type (Standard est la 
valeur par defaut). Cliquez sur OK. Le gestionnaire de projet ajoute cette 
nouvelle cible a votre projet. 

Pour visualiser un exemple de projet contenant deux cibles, ouvrez le fichier 
MULTITRG.IDE dans le repertoire EXAMPLES \ IDE \MULTITRG. Ce projet 
cree deux versions du programme WHELLO (une version 16 bits et une 
version 32 bits). Ce fichier de projet contient un fichier texte qui explique 
comment utiliser deux (ou plus) cibles dans un projet. 

Si votre projet contient plusieurs cibles, vous pouvez creer une seule cible, 
plusieurs cibles ou tout le projet. Voir la section "Construction d'un projet" 
plus loin dans ce chapitre, pour plus de precision. 

Le gestionnaire de projet de cette nouvelle version peut utiliser des projets 
issus des versions precedentes de Borland C++ pour Windows. Choisissez 
Project I Open project, puis entrez le nom du projet cree avec une version 
precedente. II est possible de changer les attributs de recherche de * . IDE en 
* . PRJ pour voir les projets des versions 3.0 et 3.1. 

Le gestionnaire de projet convertit l'ancien projet au nouveau format. 
Pensez a sauvegarder l'ancienne version si vous souhaitez continuer a 
utiliser une version anterieure de Borland C++. Pour enregistrer le projet, 
choisissez Options I Save. Cochez l'option Project, puis cliquez sur OK. Le 
nouveau projet conserve son nom, auquel est ajoutee l'extension .IDE. 



Conversion de 
projets en fichiers 
MAKE 



Vous pouvez convertir les fichiers de projets Borland C++ (.IDE) en fichiers 
MAKE (.MAK) depuis l'EDI. Pour ce faire : 

1. Ouvrez le projet (fichier .IDE) a convertir. 

2. Choisissez Project I Generate Makefile. L'EDI genere un fichier MAKE 
du meme nom et lui ajoute l'extension .MAK. L'EDI affiche ce nouveau 
fichier MAKE dans une fenetre de l'editeur. 
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Modification de la Par defaut, la fenetre d'edition affiche le noeud, la cible et les dependances. 
visualisation du Pour modifier l'affichage, utilisez la boite de dialogue Options I 

projet Environment. 

1. Choisissez Options I Environment. 

2. Choisissez Project View. Une liste d'options s'affiche. 

3. Cochez les options de votre choix. Le noeud-type WHELLO est modifie en 
fonction des options que vous selectionnez. II vous montre l'aspect que 
prendront les noeuds dans la fenetre d'edition. La liste ci-dessous decrit 
chaque option : 

■ Build translator indique le traducteur utilise pour le noeud. 

■ Code size indique la taille totale, en octets, des segments de code. 
Cette information n'apparait que lorsque le noeud a ete compile. 

■ Data size indique la taille totale, en octets, des segments de donnees. 
Cette information n'apparait que lorsque le noeud a ete compile. 

■ Description affiche une description du noeud. Pour entrer une 
description, utilisez la boite de dialogue Edit Node attributes du 
TurboMenu. 

■ Location indique le chemin d'acces du fichier source associe au noeud. 

■ Name indique le nom du noeud. 

■ Number of lines indique le nombre de lignes de code dans le fichier 
associe au noeud. Cette information n'apparait que lorsque le code a 
ete compile. 

■ Node type indique le type du noeud ( . cpp ou . c, par exemple). 

■ feuille de Style indique quelle feuille de style est associee au noeud. 

■ Output indique quel fichier (avec son chemin d'acces) est cree par le 
noeud lors de sa traduction. Ainsi, par exemple, un noeud .CPP cree un 
fichier .OBJ. 

■ Show runtime nodes indique quels noeuds le gestionnaire de projet 
utilise lors de la creation du projet. II peut contenir, par exemple, le 
code et les bibliotheques de demarrage. 

■ Show project node affiche le noeud de l'integralite du projet. Le 
noeud est cree lorsque vous choisissez Project I Build all. Notez que 
toutes les cibles sont dependantes du noeud de projet. 
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Creation d'un projet 



Procedez comme suit pour generer un projet : 

1. Ouvrez le projet a generer en choisissant Project I Open dans le menu 
principal. 

2. Choisissez Project I Build all pour generer tous les noeuds du projet, 
meme s'ils sont a jour. Si vous choisissez Project I Make all, seuls les 
noeuds dont les dependances ont ete modifies seront generes. 

Le gestionnaire de projet genere le projet en utilisant la feuille de style 
des options par defaut (la "Default Project Options StyleSheet"), sauf si 
vous associez une feuille de style specifique a un noeud ou si vous avez 
choisi d'autres options locales. Voir la section "Utilisation des feuilles de 
style" plus loin dans ce chapitre pour de plus amples informations. 

Le gestionnaire de projet analyse la premiere cible, puis descend dans le 
projet jusqu'a ce qu'il rencontre un noeud sans dependances. Le 
gestionnaire de projet cree d'abord ce noeud (et les autres noeuds de meme 
niveau), puis remonte l'arborescence du projet. 

Par exemple, si vous avez un projet avec un fichier cible .EXE dependant 
d'un fichier .CPP, le gestionnaire de projet compile le fichier .CPP en un 
fichier .OBJ puis utilise ce fichier .OBJ pour creer le fichier .EXE. 

Si vous choisissez Make all, le gestionnaire de projet verifie, a l'aide de sa 
date et de son heure, si le fichier a ete modifie. Si c'est le cas, le gestionnaire 
de projet genere a nouveau ce fichier puis remonte dans l'arborescence du 
projet et verifie la date et l'heure de modification du fichier suivant. Le 
gestionnaire de projet analyse tous les noeuds d'un projet et genere tous 
ceux qui sont obsoletes. 



Construction d'une Vous pouvez generer une partie d'un projet de trois facons differentes : 

partie de projet ^ , , , ., 

■ En generant un noeud et ses dependances, 

1. Selectionnez le noeud a generer. 

2. Cliquez, avec le bouton droit, sur le noeud (ou appuyez sur Alt+FW) et 
choisissez Build node dans le TurboMenu. Tous les noeuds dependants 
sont generes, qu'ils soient obsoletes ou non. 
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Pour generer un projet en utilisant MAKE : 

1. Selectionner le noeud a generer. 

2. Cliquez, avec le bouton droit, sur le noeud (ou appuyez sur Alt+F10) et 
choisissez Make node dans le TurboMenu. MAKE ne genere que les 
noeuds qui ne sont pas a jour. Pour de plus amples informations sur 
MAKE et ses criteres de selection des fichiers a generer, voir le chapitre 12. 

Pour traduire un seul noeud : 

1. Selectionnez le noeud a traduire. 

2. Choisissez Project I Compile dans le menu principal ou selectionnez la 
commande de traduction par defaut dans le TurboMenu. Ainsi, si vous 
avez selectionne un fichier .CPP, le TurboMenu contient la commande 
C++ Compile, qui ne compile que le noeud selectionne. 

La commande Project I Compile traduit le noeud en cours si la fenetre 
d'edition est selectionnee. Si une fenetre d'editeur est selectionnee, la 
commande Project I Compile traduit le texte affiche dans l'editeur. 



Modification de I'arborescence du projet 



Vous pouvez modifier I'arborescence du projet a l'aide du clavier ou en 
utilisant les menus. Certaines commandes n'apparaissent que dans le 
TurboMenu. Pour afficher un TurboMenu dans la fenetre d'edition, 
selectionnez un noeud et appuyez sur Alt+F10. Les options disponibles dans 
le TurboMenu varient en fonction du type du noeud selectionne. 

Lorsque vous modifiez un projet, vous pouvez ajouter, supprimer et 
deplacer des cibles et des noeuds, et vous pouvez copier des noeuds. II est 
egalement possible de modifier les attributs des noeuds et des cibles. 



Modification des 
attributs de cible 
avec TargetExpert 



Les attributs de cible definissent un type de cible. II peut s'agir, par exemple, 
d'une DLL Windows 16 bits a transformer en 32 bits. II est possible de 
modifier les attributs des cibles Standard et AppExpert, mais pas ceux des 
cibles Source Pools (voir la section "Utilisation des Source Pools", plus loin 
dans ce chapitre). De plus, vous ne pouvez pas modifier le type de la cible 
(de Source Pool en AppExpert, par exemple). 
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Pour modifier les attributs d'une cible Standard ou App Expert : 

1. Selectionnez une cible dans la fenetre d'edition. 

2. Appuyez sur Alt+F10 ou cliquez, a l'aide du bouton droit, sur le noeud 
cible. 

3. Choisissez TargetExpert dans le TurboMenu. La boite de dialogue 
TargetExpert s'affiche. 

4. Modifiez les attributs de la cible puis cliquez sur OK. Vous trouverez 
plus de details sur les attributs a la section "Creation d'un projet", au 
debut de ce chapitre. 



Modification des Les attributs de noeud definissent un noeud, ainsi que les options et le 

attributs de noeud traducteur a utiliser pour sa traduction. Pour modifier ces attributs : 

1. Selectionnez un noeud dans la fenetre d'edition. 

2. Appuyez sur Alt+FW ou cliquez, a l'aide du bouton droit, sur le noeud. 

3. Choisissez Edit node attributes dans le TurboMenu. La boite de dialogue 
Node Attributes s'affiche. 

4. Modifiez les attributs du noeud, puis cliquez sur OK. Ces attributs, qui 
s'affichent generalement dans la fenetre d'edition, sont definis ainsi : 

■ Name indique le nom du noeud. 

■ Description est un texte qui decrit le noeud. 

■ Style Sheet est le nom de la feuille de style que le gestionnaire de 
projet utilise pour traduire ce noeud. Si «None» est affiche, cela 
signifie que le gestionnaire de projet utilise la feuille de style du parent. 

■ Translator indique le nom du traducteur utilise pour ce noeud. II s'agit 
generalement du traducteur par defaut pour le type du noeud (Cpp 
Compile pour un noeud .CPP). Si vous changez de traducteur, les 
"builds" et les fichiers MAKE de ce noeud seront affectes. Pour plus de 
details, voir la section "Traducteurs, plus loin dans ce chapitre". 

■ Node type definit le noeud et indique les traducteurs disponibles pour 
ce noeud. 
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Ajout et 

suppression de 
noeuds 

Vous pouvez aussi 

utiliser le TurboMenu 

pour ajouter des 

noeuds. 



Pour ajouter un noeud au projet : 

Appuyez sur Alt+FW, puis choisissez Add node. Avec cette command e, il est 
possible d'ajouter plusieurs noeuds. 

1. Selectionnez le noeud sous lequel vous desirez inserer le nouveau noeud. 
Pour qu'il s'insere sous la cible, selectionnez le noeud cible. 

2. Appuyez sur Inser ou cliquez, a l'aide du bouton droit, sur le noeud 
selectionnez et choisissez Add node dans le TurboMenu. 

3. Choisissez le(s) fichier(s) a associer a ce nouveau noeud ou entrez le nom 
du noeud a ajouter (si ce fichier n'existe pas dans le repertoire actif, l'EDI 
le cree). 

4. Cliquez sur OK. Le nouveau noeud s'affiche sous le noeud selectionne. 
Pour ajouter plusieurs noeuds a un projet : 

1. Ouvrez le gestionnaire de fichiers de Windows et selectionnez les fichiers 
a ajouter sous forme de noeuds a votre projet. Vous devez voir la fenetre 
d'edition dans l'EDI. 

2. Deplacez les fichier depuis le gestionnaire de fichiers. Le gestionnaire de 
projet les ajoute automatiquement sous le noeud selectionne. 

Pour supprimer un noeud du projet, selectionnez-le et appuyez sur Suppr, ou 
choisissez Delete node dans le TurboMenu. Pour supprimer plusieurs 
noeuds en meme temps, selectionnez-les en appuyant sur Ctrl ou Maj tout en 
cliquant dessus - avec le bouton gauche - , puis appuyez sur Suppr. Avant 
d'effacer les noeuds selectionnes, le gestionnaire de projet vous demande 
confirmation. 



Ajout et 

suppression de 
cibles 



Pour ajouter une cible au projet : 

1. Choisissez Project I New target dans le menu principal. 

2. Entrez le nom de la nouvelle cible et choisissez son type : 

■ Standard (valeur par defaut) peut etre un executable, une DLL ou un 
autre fichier. 

■ AppExpert est une application ObjectWindows. Voir le chapitre 
AppExpertCh pour de plus amples informations sur ce type de cible. 

■ Source Pool est un ensemble de fichiers pouvant etre references dans 
d'autres cibles (voir la section "Utilisation des Source Pools", plus loin 
dans ce chapitre). 
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3. Cliquez sur OK. Si la cible est de type Standard, la boite de dialogue 
TargetExpert s'affiche, vous permettant de definir d'autres options (voir 
la page la section "Creation d'un projet" au debut de ce chapitre pour de 
plus amples informations sur les options disponibles). Si la cible est de 
type App Expert, reportez-vous au chapitre 4. Si elle est de type Source 
Pool, elle est ajoutee au projet et vous pouvez lui ajouter des noeuds 
immediatement. 

Pour supprimer une ou plusieurs cibles : 

1. Selectionnez la cible et activez le TurboMenu (cliquez sur la cible a l'aide 
du bouton droit, ou appuyez sur Alt+F10). 

2. Choisissez Delete node. 

3. Le gestionnaire de projet vous demande de confirmer la suppression. 
Cliquez sur OK. Notez bien que vous ne pouvez pas annuler cette operation. 



Deplacement des 
noeuds et des 
cibles 



Vous pouvez deplacer des noeuds ou des cibles de plusieurs facons : 

■ Faites glisser le noeud avec la souris. II se place sous le noeud selectionne 
lorsque vous relachez le bouton. 

■ Selectionnez le noeud et appuyez sur Alt et les touches flechees. Le noeud 
se deplace vers le haut ou le bas, le long des noeuds visibles. Vous pouvez 
aussi utiliser la touche Alt et les touches flechees Gauche et Droite pour 
deplacer un noeud a travers les niveaux de dependance. Par exemple, si 
un fichier d'en-tete est dependant d'un fichier .CPP (le fichier .H est place 
sous le fichier .CPP dans la fenetre d'edition), vous pouvez amener 
l'en-tete au meme niveau que le fichier .CPP en selectionnant le premier et 
en appuyant sur Alt+Gauche. 



Copie de noeuds 



Les noeuds peuvent etre copies completement ou par reference. Une copie 
complete vous permet de prendre le noeud et ses attributs et d'en placer une 
copie conforme, mais distincte, a un autre emplacement du projet. Une telle 
copie herite des attributs de son parent, sauf si vous passez outre certaines 
options. 

Une copie de reference vous permet de prendre un noeud et ses 
dependances et de les referencer dans un autre emplacement du projet ; une 
copie de reference n'est pas une copie distincte : si vous ajoutez ou 
supprimez des dependances dans l'original, la copie de reference est mise a 
jour automatiquement. Une telle copie est une copie d'un noeud et de ses 
dependances. 
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Pour effectuer une copie complete d'un noeud : 

1. Selectionnez le(s) noeud(s) a copier (utilisez Maj ou Ctrl pour etendre la 
selection). Si un noeud compte des dependances, ils sont 
automatiquement copies, sans que vous ayez a les selectionner. 

2. Maintenez la touche Ctrl enfoncee et faites glisser les noeuds selectionnes 
a l'endroit desire. 

3. Lorsque vous relachez le bouton, les noeuds copies apparaissent. Si vous 
modifiez le noeud original, la copie complete n'est pas modifiee. 

Pour effectuer une copie de reference, 

1. Selectionnez le noeud a copier. Meme si vous ne les selectionnez pas, les 
dependances du noeud selectionne seront automatiquement copies. 

2. Maintenez la touche Alt enfoncee et faites glisser le noeud a l'endroit 
choisi pour la copie de reference. 

3. Lorsque vous relachez le bouton, le noeud copie apparait, dans une 
police maigre (non grasse). Ceci vous rappelle qu'il s'agit d'une copie de 
reference et non pas d'une copie complete. Si vous modifiez le noeud 
original, toutes les copies de reference sont mises a jour. 

Mise en garde ! Si vous supprimez un noeud original, toutes les references a ce noeud seront 
aussi effacees, sans possibilite d'annulation. 

Utilisation des Source Pools 

Un "Source Pool" (Ensemble de Sources) est un groupe de noeuds. Une cible 
Source Pool n'est pas generee, mais peut etre referencee lors d'une creation. 
Les Source Pools permettent a differentes cibles d'utiliser le meme code 
source. Ils sont par exemple tres utiles si vous creez deux applications, l'une 
16 bits et la seconde 32. Pour voir un exemple de Source Pools, ouvrez le 
projet SRCPOOL.IDE dans le repertoire EXAMPLES \ IDE \SRCPOOL. II 
contient un fichier texte qui explique comment le Source Pool est ici utilise. 

Les Source Pools peuvent contenir plusieurs fichiers que vous souhaitez 
copier par reference dans votre projet. Par exemple, vous pouvez avoir 
plusieurs en-tetes a placer a divers endroits du projet. Si vous placez ces 
fichiers dans un Source Pool, puis copiez ce dernier par reference, il vous 
suffira de modifier le Source Pool original. Ainsi, si vous ajoutez un en-tete 
dans le Source Pool, toutes les copies referencees seront immediatement 
mises a jour. 
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Les Source Pools sont particulierement utiles pour assigner une seule feuille 
de style a plusieurs cibles. Par exemple, si vous avez trois cibles dans un 
projet et souhaitez que toutes les cibles utilisent la meme feuille de style, 
vous pouvez soit associer la feuille de style a chaque cible, individuellement, 
soit placer les cibles sous un Source Pool puis associer la feuille de style au 
noeud du Source Pool. Si vous desirez reassigner une feuille de style (pour, 
par exemple, compiler sans informations de debogage), il vous suffira alors 
de reassigner la feuille de style au Source Pool, et non pas a chaque cible. 



Definition des options d'un projet 



Lorsque vous avez cree un projet, il se peut que vous souhaitiez modifier les 
options de creation par defaut. Ces options indiquent au gestionnaire de 
projet comment il doit creer votre projet, en specifiant, par exemple, si vous 
desirez inclure les informations de debogage dans votre application. 

Pour modifier les options d'un projet : 

1. Choisissez Options I Project. Une boite de dialogue s'affiche. 

2. Modifiez certaines options. Voir les chapitres 1 et 3 pour de plus amples 
informations sur les options. 

2. Cliquez sur OK pour valider vos modifications. 

Lorsque vous creez votre projet, les options definies s'appliquent a 
l'integralite du projet. Si vous creez un nouveau projet, il utilise par defaut 
les options du dernier projet ouvert. 

Vous souhaiterez parfois definir des options specifiques pour l'un des 
noeuds du projet (pour, par exemple, compiler un seul fichier sans 
informations de debogage). Pour activer des options differentes pour un 
noeud, utilisez Local Override ou une feuille de style. 



Derogation locale II est possible, localement, d'utiliser d'autres options que celles qui ont ete 
definies pour l'ensemble du projet. Cette fonctionnalite s'appelle la 
derogation locale ("Local Override"). Ceci est utile lorsque vous desirez 
appliquer des options differentes a un noeud precis. Si vous desirez deroger 
a de nombreuses options, utilisez une feuille de style separee (voir la section 
qui suit pour de plus amples informations sur les feuilles de style). 
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Pour deroger a une option, 

1. Choisissez le noeud auquel vous souhaitez appliquer des options 
distinctes. 

2. Cliquez, a l'aide du bouton droit, sur le noeud (ou appuyez sur Alt+F10) et 
choisissez Edit local options dans le TurboMenu. La boite de dialogue 
Style Sheet s'affiche, detaillant les options utilisees pour le noeud. 

3. Selectionnez l'option a modifier. La case Local Override est 
automatiquement cochee. 

4. Cliquez sur OK. 

Mise en garde ! Pour annuler une derogation, deselectionner Local Override. La coche dans 
Local Override n'est visible que lorsque le curseur se trouve dans l'option a 
laquelle vous derogez, ce qui rend difficile son reperage. La case Local 
Override est gris fonce si aucune des options de cette section n'est 
remplacee par une autre. Elle devient gris clair si l'une des options est 
remplacee, mais vous devez quand meme les selectionner l'une apres l'autre 
pour savoir de laquelle il s'agit. 

Si vous derogez a plus de deux options, il est souhaitable d'utiliser une 
feuille de style propre a ce noeud. 



Utilisation des Les feuilles de style sont un ensemble d'options de creation (les "build 

feuilles de style options") s'appliquant a un projet. Chaque projet utilise un jeu d'options par 

defaut, qui sont enregistrees dans une feuille de style. Par defaut, un projet 
utilise la feuille de style nommee "Default Project Options" (Options par 
defaut pour un projet) . Les parametres contenus dans la feuille de style 
influent sur la facon dont sera cree le projet. Si tous les composants du projet 
peuvent etre crees avec les memes options, vous pouvez les definir a l'aide 
de la boite de dialogue Options I Project. Ceci vous permet de modifier la 
feuille de style "Default Project Options". Si vous ne souhaitez modifier que 
les options d'un seul noeud, utilisez la fonction Local Override ; si vous 
vous apercevez que vous utilisez souvent cette derniere, il peut etre 
preferable d'utiliser une feuille de style. 

Lors de la creation d'un projet, c'est la feuille de style du projet qui est 
utilisee, sauf si le noeud en cours de creation est associe a une feuille de style 
distincte ou utilise Local Override (voir la section precedente pour de plus 
amples informations sur Local Override). II est possible d'utiliser des 
feuilles de style et Local Override, notamment dans le cas ou vous avez 
associe une feuille de style a vos cibles mais souhaitez la modifier 
legerement pour traiter un noeud place sous la cible. 
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Association d'une 
feuille de style a un 
noeud 



Lorsque le gestionnaire de projet cree un noeud, il utilise la feuille de style 
du noeud, ainsi que toute option definie dans Local Override. Si aucune 
feuille de style n'est associee au noeud, le gestionnaire de projet utilise la 
feuille de style du parent du noeud. Si celui-ci ne comporte pas non plus de 
feuille de style, le gestionnaire de projet analyse le parent suivant, jusqu'a ce 
qu'il en trouve une. En dernier ressort, c'est la feuille de style du projet qui 
est utilisee. 

En regie generale, les differents noeuds d'un projet doivent etre crees avec 
des options differentes. Vous compilez, par exemple, les fichiers .C avec 
certaines options, les fichiers .CPP avec d'autres, ou vous creez une cible au 
format 16 bits et une autre au format 32 bits. A titre d'exemple, ouvrez le 
projet STYLESHT.IDE situe dans le repertoire 

\EXAMPLES\IDE\STYLESHT. Ce fichier utilise une feuille de style 
differente pour chaque cible (deux versions du programme WHELLO). Ce 
projet contient en outre un fichier texte decrivant l'utilisation des feuilles de 
style. 

Le gestionnaire de projet contient plusieurs feuilles de style utilisables, mais 
vous pouvez egalement creer les votres. Pour associer une feuille de style a 
un noeud : 

1. Selectionnez le noeud et cliquez dessus, a l'aide du bouton droit. 

2. Choisissez Edit node attributes. 

3. Selectionnez une feuille de style dans la boite liste qui s'affiche. 

4. Cliquez sur OK. 

Vous pouvez aussi cliquer sur le bouton Styles pour creer une feuille de 
style. Reportez-vous a la section qui suit pour de plus amples informations 
sur la creation de vos propres feuilles de style. 



Creation d'une 
feuille de style 



Pour creer une feuille de style dans un projet : 

1. Choisissez Options I Style Sheets dans le menu principal. 

2. Cliquez sur Create. Entrez le nom de la feuille de style et appuyez sur 
Entree. 

3. Cliquez sur Edit. La boite de dialogue Style Sheet s'ouvre. 

4. Modifiez, si vous le souhaitez, certaines options de votre nouvelle feuille 
de style. La plupart de ces options sont decrites au chapitre Options. 

5. Cliquez sur OK pour valider vos modifications. 
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Modification d'une Une feuille de style peut etre modifiee, renommee ou copiee. Choisissez 
feuille de style Options I Style Sheets pour afficher la boite de dialogue Style Sheets. Les 

options disponibles sont les suivantes : 

■ Compose vous permet de creer une feuille de style contenant des options 
combinees a partir d'une ou de plusieurs feuilles de style : 

1. Creez une nouvelle feuille de style (cliquez sur New et entrez son nom), 
puis cliquez sur Compose. 

2. Selectionnez la feuille de style a inclure dans cette nouvelle feuille, puis 
cliquez sur Add. 

3. Repetez l'operation aussi souvent que necessaire, puis cliquez sur OK. II 
n'est pas possible de modifier une feuille de style composee, mais vous 
pouvez a nouveau cliquer sur Compose pour ajouter ou supprimer des 
feuilles de style. 

■ Pour copier une feuille de style : 

1. Selectionnez une feuille de style et cliquez sur Copy. 

2. Entrez le nom de la feuille de style de destination puis cliquez sur OK. II 
devient alors possible de cliquez sur Edit pour modifier certaines de ses 
options. La copie represente la solution la plus rapide pour creer une 
feuille de style dont les parametres sont semblables, dans leur majorite, a 
ceux d'une feuille de style existante. 

■ Pour modifier une feuille de style : 

1. Selectionnez-la et cliquez sur Edit. 

2. Modifiez les options de votre choix et cliquez sur OK. 

■ Pour renommer une feuille de style : 

1. Selectionnez-la et cliquez sur Rename. 

2. Entrez le nouveau nom de la feuille de style et cliquez sur OK. 

■ Pour supprimer une feuille de style, selectionnez-la et cliquez sur Remove. 

Partage de feuille Si vous creez des feuilles de style pour un projet, puis choisissez Project I 
de styles New project, le nouveau projet herite des feuilles de style (ainsi que des 

outils et des options) de l'ancien projet. Cependant, si vous fermez un projet 
ou relancez l'EDI, vous devrez ouvrir a nouveau le projet avec ses feuilles 
de style, puis creer un nouveau projet pour que celui-ci herite des feuilles de 
style. 
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II existe une autre facon de partager des feuilles de style entre plusieurs 
projets. A chaque fois que vous creez un fichier de projet (.IDE), vous creez 
ise en gar e . auss j un fichier .PDL (Project Description Language) qui contient des 
informations sur les feuilles de style et les outils utilises dans ce projet. 
Attention cependant : ne modifiez ce fichier que si vous etes parfaitement 
familier avec sa syntaxe. 

Lorsque vous ouvrez un fichier de projet, le gestionnaire de projet ouvre le 
fichier .PDL associe au fichier .IDE. 

Pour partager une feuille de style entre plusieurs projets : 

1. A l'aide d'un editeur de texte, ouvrez le fichier .PDL contenant la feuille 
de style a partager. 

2. Localisez le nom de la feuille de style. Par exemple, si vous avez cree la 
feuille de style MONSTYLE, une section du fichier .PDL commence par 
lachaine StyleSheet= "MONSTYLE". 

3. Copiez le texte compris entre les accolades de debut et de fin. Vous 
pouvez copier plusieurs feuilles de style. 

4. Ouvrez le fichier .PDL dans lequel vous desirez copier la feuille de style. 

5. Placez-vous dans la section des feuilles de style et collez le texte a la fin 
de la liste des feuilles de style. 

6. Enregistrez le fichier .PDL modifie. Lorsque vous ouvrirez le projet 
associe avec ce fichier modifie, les feuilles de style que vous venez de 
coller seront affichees lorsque vous choisirez Options I Style Sheets. 



Visualisation des Etant donne que chaque noeud peut avoir sa propre feuille de style et qu'il 

options d'un projet est possible de deroger aux options de cette feuille de style, il est 
indispensable de pouvoir visualiser les options des noeuds. 

Pour connaitre la hierarchie des options : 

1. Cliquez, a l'aide du bouton droit, sur un noeud du projet et choisissez 
View options hierarchy. 

La boite de dialogue Options Hierarchy s'ouvre. Elle indique tous les 
noeuds contenus dans le projet, ainsi que leurs options. Les noeuds 
d'auto-dependence ne sont pas listes. Comme dans la fenetre d'edition, il 
est possible d'etendre et de condenser la liste des noeuds. 

2. Cliquez sur le noeud a visualiser. Ses options s'affichent a sa droite. 
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Traducteurs 



3. Pour modifier une option, faites un double-clic dessus ou selectionnez-la 
et cliquez sur Edit. Si l'option appartient a une feuille de style, vous 
modifierez toute la feuille de style. S'il s'agit d'une option "Local 
Override", vous modifierez les options Local Override du noeud 
selectionne. 

4. Pour refermer la boite de dialogue, cliquez sur Close. 

La liste des options indique le nom du noeud entre crochets, suivi du nom 
de la feuille de style du noeud. Elle indique egalement les options 
auxquelles vous avez deroge. Cette hierarchie vous permet de savoir quelles 
sont les options qui sont passees aux noeuds dependants. 



Un traducteur est un programme qui modifie le type d'un fichier. Le 
compilateur, par exemple, traduit les fichiers .C et .CPP en fichiers .OBJ, et 
l'editeur de liens traduit les fichiers .OBJ, .LIB, .DEF et .PvES en un fichier 
.EXE. 

Le gestionnaire de projet vous permet de definir vos prop res traducteurs. 
Les traducteurs que vous ajoutez a un projet restent dans son fichier de 
projet ; ils ne sont pas integres de facon permanente a l'EDI. Cependant, les 
traducteurs, les feuilles de styles, les visualiseurs et tout autre outil peuvent 
etre transferes a un autre projet : si un fichier de projet ouvert contient des 
outils ou des feuilles de style de votre cru, le prochain projet que vous 
creerez (par Project I New project) heritera des ces outils. Voir la page plus 
haut la section "Partage de feuilles de style" pour de plus amples 
informations sur le partage d'outils entre projets. 

Pour visualiser les traducteurs par defaut, choisissez Options I Tools. Ceci 
permet egalement de connaitre les visualiseurs et autres outils installes. 



Installation d'un 
traducteur 



Pour installer un traducteur : 



1. 



2. 



Choisissez Options I Tools. La boite de dialogue qui s'affiche liste les 
outils, les visualiseurs et les traducteurs. II est possible aussi d'installer 
des traducteurs en choisissant Build Attributes dans le TurboMenu du 
gestionnaire de projet. 
Cliquez sur New. 
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3. Entrez le nom du traducteur, son chemin d'acces et ses eventuelles 
options de ligne de commande. Vous pouvez utiliser des macros de 
transfert dans la ligne de commande. Pour de plus amples informations 
sur ces macros, voir l'Aide en ligne. 

4. Entrez le texte du menu. Ce texte s'affichera dans les TurboMenus et 
dans le menu principal des Outils ("Tools"). Pour assigner une touche de 
raccourci a ce menu, faites preceder l'une des lettres du caracteres "&". 
Cette lettre sera soulignee dans le menu. La touche de raccourci du menu 
File, par exemple, est F. Dans le texte du menu, File serait entre sous la 
forme &File. Pour afficher le caractere "&" dans un menu, entrez deux 
fois ce caractere (par exemple, & & Test pour obtenir &Test. 

5. Tapez un eventuel texte d'aide ; celui-ci s'affichera dans la ligne d'etat 
lorsque le curseur sera sur l'option du menu. 

6. Cliquez sur Advanced pour ouvrir la boite de dialogue Tool Advanced 
Options. 

7. Cochez Translator. 

8. Cochez l'option Place on Tools menu si vous desirez que ce traducteur 
s'affiche dans le menu principal des outils. Cochez Place on TurboMenu 
si vous souhaitez qu'il s'affiche lorsque vous cliquez, a l'aide du bouton 
droit, sur un noeud associe a votre traducteur. 

9. Si vous souhaitez que le traducteur puisse traiter les cibles, cochez Target 
translator. Lorsque vous utilise ce traducteur, le noeud devient une cible 
et le fichier traduit est enregistre dans le repertoire Final. Si vous ne 
cochez pas cette option, le fichier traduit est enregistre dans le repertoire 
intermediate. 

10. Entrez l'extension des fichiers que vous souhaitez associer avec ce 
traducteur. BCC, par exemple, est le traducteur des fichiers .C et .CPP, 
aussi l'option Translate From contiendrait-elle . c ; . cpp : . Le caractere 
";" separe les diverses extensions et le caractere ":" indique la fin de la 
liste. 

11. Entrez l'extension du fichier traduit gene re. BCC, par exemple, 
convertissant les fichiers .CPP en fichiers .OBJ, . ob j est affiche dans la 
case Translate to. 

12. Si vous voulez que ce nouveau traducteur soit utilise par defaut pour un 
type de noeud, entrez l'extension du fichier et le caractere ":" dans la case 
Default for. 

13. Cliquez sur OK. 
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Utilisation de 
Special dans le 
TurboMenu 



Dans le TurboMenu, certains noeuds ont une commande Special qui liste les 
autres traducteurs pour le type de noeud selectionne. Vous voyez, par 
exemple, les commandes Assembler Output et Preprocess si un noeud .CPP 
est selectionne, mais vous voyez la commande Implib si c'est un noeud .DLL 
qui est selectionne. 



Installation de Un visualiseur vous permet de voir le contenu du noeud selectionne. Ainsi, 

visualiseurs et un editeur est un visualiseur qui vous permet de parcourir le code d'un 

d'outils fichier .CPP. Dans le TurboMenu d'un noeud .CPP, la commande Text Edit 

est disponible. L'editeur par defaut pour la vue Text Edit est l'editeur de 

l'EDI. 

Pour visualiser un noeud, vous pouvez : 

■ Faire un double-clic sur le noeud de votre choix dans la fenetre d'edition, 
ou 

■ Cliquer dessus, a l'aide du bouton droit, et choisir View pour afficher la 
liste des visualiseurs utilisables. 

Les visualiseurs disponibles sont fonction du type du noeud selectionne. 
Ainsi, Resource Workshop peut visualiser les fichiers .RC. II n'est pas 
possible d'afficher un noeud .EXE dans un editeur de texte, mais vous 
pouvez l'ouvrir avec le debogueur integre, avec Turbo Debugger pour 
Windows, avec ObjectBrowser ou sous la forme d'un executable. 

Les outils sont des applications que vous souhaitez lancer depuis l'EDI 
(TurboDebugger ou GREP, par exemple). La procedure d'installation des 
visualiseurs et des outils est la meme que pour les traducteurs. Pour de plus 
amples informations, reportez-vous a la section "Traducteurs" de ce chapitre. 
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Compilation 



Les applications peuvent etre compilees dans l'EDI (Environnement de 
Developpement Integre) ou au moyen du programme BCC.EXE 
(applications 16 bits) ou BCC32.EXE (applications 32 bits) lance a partir de la 
ligne de commande. Les options du compilateur vous permettent de 
controler la generation du code en definissant le type d'application a creer 
(une version de debogage par exemple), l'emplacement des fichiers 
d'en-tete et des bibliotheques de liaison, la gestion du code C++ et bien 
d'autres aspects. 

Ce chapitre se divise en trois sections : 

■ Compilation dans l'EDI ; 

■ Compilation au moyen du programme BCC ou BCC32 ; 

■ Options du compilateur. 

La table des options indique les options du compilateur en ligne de 
commande et les options correspondantes dans l'EDI. Les options de 
compilation sont regroupees par sujet dans la boite de dialogue Options I 
Projet ou elles font l'objet d'une description plus detaillee. 
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Compilation dans I'EDI 



IDDICI 



IOOIOI 



Cette section vous explique comment compiler de simples programmes au 
moyen des options de compilation dans l'EDI. Pour apprendre a compiler 
des programmes plus complexes, reportez-vous au chapitre 2. 

La barre d'icones de l'EDI contient trois boutons de compilation qui 
correspondent a des commandes de menu : 

Project I Compile (Alt+F9) compile le code dans la fenetre d'edition 
selectionnee au moyen des options de compilation definies dans la boite de 
dialogue Project Options. Si vous choisissez une fenetre de projet, tous les 
noeuds selectionnes dans le projet sont traduits ; les noeuds fils ne sont 
traduits que s'ils ont ete selectionnes (pour plus de details sur les 
traducteurs, reportez-vous au chapitre 2). 

Project I Make All (F9) traduit tous les noeuds perimes d'un projet. Si aucun 
projet n'est ouvert, tous les fichiers contenus dans les fenetres d'edition sont 
compiles au moyen des traducteurs de projet par defaut. 

Project I Build All traduit tous les noeuds d'un projet - meme s'ils sont a 
jour. La commande Project I Build All compile le projet en commencant par 
son premier noeud. Pour interrompre l'operation, cliquez sur Cancel. 



Utilisation des 
options de 
compilation 
dans I'EDI 



II existe deux moyens de definir les options de compilation dans l'EDI : 

■ En selectionnant Options I Project pour definir les options requises dans 
la boite de dialogue. Ces options sont utilisees lorsque vous effectuez une 
compilation sans avoir charge de fichier de projet. Si un projet est charge, 
les options sont appliquees a l'ensemble du projet durant sa compilation. 

■ Les options de projet doivent etre definies localement pour chaque fichier 
en utilisant le gestionnaire de projet. Pour plus de details sur les options 
locales, reportez-vous au chapitre 2. 
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Exemple : pour compiler un code qui genere une application 32 bits destinee 
a un processeur 80386 dans une fenetre d'edition (sans projet charge), 
procedez de la maniere suivante : 

1. Selectionnez la fenetre d'edition qui contient le code a compiler. 

2. Selectionnez la commande Options I Project dans le menu. 

3. Dans la boite de dialogue Project Options, cliquez sur le sujet 32-bit 
Compiler pour afficher les sous-sujets, puis cliquez sur Processor. 

4 Les options reservees aux processeurs 32 bits s'affichent sur la droite. 
Cochez l'option 80386. Elle demeure en vigueur jusqu'a ce que vous 
choisissiez un autre type de processeur ou que vous sortiez de l'EDI. 
Pour en faire l'option par defaut (qui selectionnera automatiquement une 
application 32 bits pour processeur 80386 a chaque operation de 
compilation), choisissez Options I Save dans le menu principal. 

5. Cliquez sur le bouton de compilation dans la barre d'icones, ou 

selectionnez Project I Compile (cette commande compile le code dans la 
fenetre d'edition courante si aucun projet n'a ete charge). 

Utilisation des compilateurs en ligne de commande 

Cette section vous explique comment utiliser les compilateurs en ligne de 
commande (BCC.EXE et BCC32.EXE). BCC.EXE est une application 16 bits 
qui genere du code 16 bits, alors que BCC32.EXE, comme son nom l'indique, 
est une application 32 bits generant du code 32 bits. BCC et BCC32 
fonctionnent de la meme maniere, mais possedent des valeurs par defaut 
differentes (comme indique dans la table des option) et generent un code 
different. Sauf indication contraire, les instructions et options specifiers pour 
BCC s'appliquent egalement a BCC32. 

Vous pouvez utiliser BCC pour envoyer des fichiers a TLINK ou TASM 
(fichiers .ASM si vous avez installe TASM sur votre machine). La syntaxe 
generale de BCC.EXE est la suivante : 

: BCC [option [option...]] fichier [fichier...] 
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Pour obtenir la liste des options de compilation les plus couramment 
utilisees, tapez BCC (sans preciser d'option ni de nom de fichier) et appuyez 
sur Entree. La commande BCC doit etre separee de chaque option ou nom 
de fichier par au moins un espace. Chaque option doit en outre etre 
precedee d'un tiret (-) ou d'unebarre oblique (/) ; a titre d'exemple, pour 
specifier un type de chemin d'inclusion, vous devez specifier : 

BCC -Ic:\code\Fich_h 

Les options et noms de fichier specifies en ligne de commande ont priorite 
sur les valeurs par defaut contenues dans les fichiers de configuration. 

Par defaut, BCC compile les fichiers sans extension et les fichiers .CPP en 
tant que fichiers C++. Les fichiers ayant l'extension .C ou une extension 
autre que .CPP, .OBJ, .LIB ou .ASM sont compiles en tant que fichiers C. 

BCC.EXE et BCC32.EXE possedent des options actives par defaut (ces 
options sont signalees par un petit carre noir dans le tableau 3.1 dans la table 
des options). Pour desactiver une option par defaut, tapez BCC -option-. 

Par defaut, BCC essaie de realiser une edition de liens avec un fichier de 
definition de module du meme nom que le fichier executable. Utilisez 
TLINK pour lier un fichier de definition de module portant un nom 
different. II n'est pas possible de lier plus d'un fichier de definition de 
module. 



Fichiers de 
configuration 



TURBOC.CFG 

configure BCC.EXE 

et BCC32.CFG 

configure 

BCC32.EXE ; les 

fichiers de projet 

(.IDE) configurent 

I'EDI. 



Si vous avez l'occasion d'utiliser regulierement un ensemble d'options 
particulier a partir de la ligne de commande, vous pouvez les definir dans 
un fichier de configuration (fichier texte ASCII standard). Les options doivent 
etre separees les unes des autres par un espace et peuvent figurer sur une 
seule ligne ou plusieurs. 

Par defaut, BCC.EXE utilise le fichier de configuration TURBOC.CFG, tandis 
que BCC32.EXE utilise le fichier BCC32.CFG (les options par defaut 
correspondants sont signalees par un petit carre noir dans le tableau 3.1). 
Les compilateurs commencent par rechercher les fichiers .CFG dans le 
repertoire a partir duquel vous avez lance BCC, puis dans le repertoire ou 
est stocke BCC.EXE ou BCC32.EXE. 
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Fichiers de 

recherche 



Regies de priorite 
des options 



Vous pouvez creer de multiples fichiers de configuration ou modifier 
TURBOC.CFG. Pour utiliser un fichier de configuration, tapez 
+ [chemin] fichier sur la ligne de commande BCC. Pour utiliser le fichier 
de configuration MACONFIG.CFG, vous devez done entrer la commande 
suivante sur la ligne de commande : 

BCC +C: \MACONFIG.CFG moncode . epp 

Les options definies en ligne de commande BCC ont priorite sur celles qui 
sont fournies par les fichiers de configuration. 

Pour specifier plusieurs options ou fichiers sur la ligne de commande, 
entrez-les dans un fichier de recherche (fichier texte ASCII standard). Les 
fichiers de recherche vous permettent d'utiliser une ligne de commande 
plus longue que celle disponible sur la plupart des systemes d'exploitation. 

Pour utiliser un fichier de recherche : 

1. Entrez les options en ligne de commande que vous souhaitez utiliser 
dans un fichier et sauvegardez-le. Ces options peuvent etre definies sur 
une ou plusieurs ligne dans le fichier, mais doivent etre separees les unes 
des autres par des espaces. Les fichiers de recherche fournis avec Borland 
C++ ont l'extension .RSP. 

2. Tapez BCC @@ [chemin]fichrech. rsp. 

Vous pouvez egalement specifier plus d'un fichier de recherche au moyen 
de la commande suivante : 

BCC @@ [chemin] f ichrech . rsp@@ [chemin] autref ic . rsp . 
Les options definies en ligne de commande ont priorite sur les options 
correspondantes et les noms de fichier specifies dans un fichier de recherche. 

BCC.EXE et BCC32.EXE evaluent les options de gauche et a droite selon les 
regies suivantes : 

■ Lorsqu'une option est dupliquee, a l'exception de -I et de -L, la derniere 
valeur attribuee est prise en compte. 

■ Si vous definissez plusieurs options -L ou -I sur la ligne de commande, le 
resultat est cumule : le compilateur consulte tous les repertoires listes de 
gauche a droite. 

■ Les options en ligne de commande ont priorite sur celles qui sont definies 
dans les fichiers de configuration et de recherche. 
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Options de compilation 



Le tableau 3.1 des options dresse la liste des options de compilation 
disponibles dans l'EDI et en ligne de commande. La plupart des options de 
l'EDI sont affichees dans la boite de dialogue Project Options ; si elles n'y 
figurent pas, l'option equivalente de l'EDI est mentionnee entre signes 
< et >. Dans l'EDI, une option est repetee lorsqu'elle peut etre activee ou 
desactivee par une case a cocher. Pour obtenir une description detaillee de 
chaque option, consultez la page correspondante specifiee dans le tableau. 

Les options par defaut des compilateurs en ligne de commande 16 et 32 bits 
sont signalees par un petit carre noir (■) ; les options applicables uniquement 
a l'un ou l'autre des compilateurs sont egalement signalees, respectivement, 
par H16 et »32par une puce carree pour b 16 etb32. A noter que dans l'EDI, les 
options par defaut sont differentes. La principale difference dans les options 
par defaut est que l'EDI compile en utilisant les informations de debogage et 
de Browser et qu'il produit des fichiers compiles plus volumineux que les 
compilateurs en ligne de commande. (Les applications ont toutefois la 
meme taille lorsque vous utilisez les memes options dans l'EDI et en ligne 
de commande.) 

Tableau 3.1 : Recapitulatif des options 



Option 


Page 


Equivalent dans l'EDI 




@fichier 


49 


[Nomdufichierdeprojet] 




+fichier 


48 


<aucune> 




-1 


90 


<aucune> 




-2 


68 


16-bit Compiler | Processor 


80286 


-3 


68 


16-bit Compiler | Processor 


80386 


-3 


76 


32-bit Compiler | Processor 


80386 


-4 


68 


16-bit Compiler Processor 


i486 


-4 


76 


32-bit Compiler Processor 


i486 


-5 


76 


32-bit Compiler | Processor 


Pentium 


-A 


66 


Compiler I Source I ANSI 





Description 

Lit les options du compilateur dans le fichier de 

recherche specifies. 

Utilise le fichier de configuration secondaire precise. 

Genere des instructions 80186. 

Genere des instructions compatibles avec le mode 

protege 80286 (16 bits uniquement). 

Genere des instructions compatibles avec le mode 

protege 80386 16 bits (option BCC). 

Genere des instructions compatibles avec le mode 

protege 80386 32 bits (option BCC32). 

Genere des instructions compatibles avec le mode 

protege 80486 16 bits (option BCC). 

Genere des instructions compatibles avec le mode 

protege 80486 32 bits (option BCC32). 

Genere des instructions compatibles avec le mode 

protege Pentium 32 bits. 

Conformite au langage ANSI. 
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Tableau 3.1 : Recapitulatif des options (suite) 



Option 



Page Equivalent dans I'EDI 



■A-, -AT 


66 


Compiler Source Borland extensions 


-AK 


66 


Compiler Source Kernighan and Ritchie 


AU 


66 


Compiler | Source | UNIX V 


■an 


76 


1 6- or 32-bit Compiler Processor Byte, 
Word, Double Word 


■a- 


68 


16-bit Compiler | Processor | Byte 


■B 


90 


<aucune> 


■b 


63 


Compiler | Code Generation | Allocate enums 
and ints 


■b- 


63 


Compiler | Code Generation | Allocate enums 
and ints (non cochee) 


■C 


65 


Compiler Source Nested Comments 


■C- 


65 


Compiler Source Nested Comments (non 
cochee) 


■c 


90 


Project Compile 


■Dnom 


62 


Compiler Defines 


■Dnom=chaine 


' 62 


Compiler Defines 



-d 63 Compiler | Code Generation | Duplicate 

strings merged 
-d- 63 Compiler | Code Generation | Duplicate 

strings merged 

-de 71 1 6-bit Compiler | Memory Model | Put strings 

in code segments 

-Efichier 91 <aucune> 

-efichier 91 <Editez les attributs de noeud dans le 

gestionnaire de projet> 

-Fc 65 Compiler | Compiler Output | Generate 

COMDEFs 

-Ff 65 1 6-bit Compiler | Memory Model | Automatic 

far data 

-Ff=fa///e 65 1 6-bit Compiler | Memory Model | Far Data 

Threshold 



Description 

Conformite au language BO 

Conformite au language Kernighan et Ritchie. 

Conformite au language UNIX V. 

Alignement sur n : 1 = octet, 2 = mot, 4 = double 
mot (32 bits uniquement). 

Alignement sur un octet. 

Compile et appelle I'assembleur pour traiter le code 

assembleur. 

enums a la taille d'entier. 

enums a la taille d'octet si possible. 

Active les commentaires imbriques. 
Desactive les commentaires imbriques. 

Compile en .OBJ, sans edition de liens. 

Attribue une chaine constitute du caractere nul 

comme nom. 

Attribue la chaine au nom. 

Fusionne les chaines dupliquees. 

Ne fusionne pas les chaines dupliquees. 

Transfere les constantes du segment de donnees 
vers le segment de code (1 6 bits uniquement). 

Utilise I'assembleur specifie. 

Effectue I'edition de liens pour produire le fichier 
specifie. 

Generedes COMDEF (C 16 bits uniquement). 

Cree automatiquement des variables far (1 6 bits 
uniquement). 

Cree automatiquement des variables far, 
selectionne "taille" comme limite (16 bits 
uniquement). 
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Tableau 3.1 : Recapitulatif des options (suite) 



Option 



-Fm 
-Fs 
-f 

-f- 
-ff 
-ff- 

-f87 
-f287 

-G 
-G- 

-gn 

-H 

-H- 

-Hc 
-Hu 

-H"xxx" 

-H=fichier 

-h 

-khemin 
-in 



Page Equivalent dans I'EDI 

65 <aucune> 

65 <TargetExpert | Alternate startup> 

64 Compiler | Floating point | No floating point 

(non cochee) 

64 Compiler | Floating point | No floating point 

64 Compiler | Floating point | Fast floating point 

64 Compiler | Floating point | Fast floating point 

(non cochee) 

91 <aucune> 

91 Compiler | Floating point | Fast floating point 

81 Optimizations | Specific | Executable Speed 

81 Optimizations | Specific | Executable Size 

87 Messages | Stop after n warnings 



68 Compiler | Precompiled headers 
and use 

68 Compiler | Precompiled headers 
generate or use 

91 <aucune> 

68 Compiler | Precompiled headers 
don't generate 

68 Compiler | Precompiled headers 
precompiling after header 



Generate 
Do not 

Use but 
Stop 



68 Compiler | Precompiled headers | 
precompiled header file name 

72 1 6-bit Compiler | Memory Model | Fast huge 
pointers 

60 Directories | Include 

65 Compiler | Source | Identifier length 



Description 

Active les options -Fc, -Ff et -Fs (1 6 bits 

uniquement). 

Suppose que DS = SS dans tous les modeles de 

memoire (DOS 16 bits uniquement). 

Permet I'utilisation de la virgule flottante. 

Ne permet pas I'utilisation de la virgule flottante. 

Calculs flottants rapides. 

Calculs en virgule flottante stricts ANSI. 

Utilise les instructions materielles 8087. 

Utilise les instructions materielles 80287 (pour 
applications DOS). 
Code le plus rapide. 

Code le plus compact. 

Avertissements : interruption au bout de 

n messages (1 00 par defaut). 

Genere et utilise des en-tetes precompiles. 

N'utilise pas d'en-tetes precompiles et ne les 
genere pas. 

En-tetes precompiles de cache. Cette option doit 
etre utilisee avec -H or -Hxxx. 
Utilise des en-tetes precompiles, mais ne les 
genere pas. 

Interrompt la compilation des en-tetes precompiles 
au fichier "xxx" (32 bits uniquement). Cette option 
doit etre utilisee avec -H, -Hu ou -H=fichier. 
Definit le nom du fichier contenant les en-tetes 
precompiles. 

Utilise I'arithmetique fast huge pointer (1 6 bits 
uniquement). 

Definit le chemin d'acces aux repertoires pour les 
fichiers include. 

Selectionne la longueur significative d'identificateur 
n (par defaut 32). 
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Tableau 3.1 : Recapitulatif des options (suite) 



Option 


Page 


Equivalent dans I'EDI 


Description 


■ -Jg 


80 


C++ Options Templates Smart 


Genere des definitions pour toutes les instances de 
modeles et fusionne les duplications. 


-Jgd 


80 


C++ Options Templates Global 


Genere des definitions publiques pour toutes les 
instances de modeles ; duplique les resultats dans 
les erreurs de redefinition. 


-Jgx 


80 


C++ Options | Templates | External 


Genere des references externes pour toutes les 
instances de modeles. 


■ -jn 


87 


Messages Stop after n errors 


Erreurs : interruption apres n messages (25 par 
defaut). 


-K 


63 


Compiler Code Generation Unsigned 
characters 


Type de caractere non signe par defaut. 


■ -K- 


63 


Compiler Code Generation Unsigned 
characters (non cochee) 


Type de caractere signe par defaut. 


-K2 


78 


C++ Options C++ Compatibility Don't treat 


Autorise uniquement deux types de caracteres 






char as distinct 


(signes et non signes) ; char est traite comme 
caractere signe (16 bits uniquement). Compatibility 
avec Borland C++ 3.1 et versions plus anciennes. 


■ -k 


66 


Compiler Debugging Standard stack frame 


Active le cadre de pile standard. 


-Lchemin 


60 


Directories Library 


Definit le chemin d'acces des fichiers bibliotheques. 


-\x 


91 


<options de I'editeur de liens> 


Passe I'option x a I'editeur de liens (peut utiliser 
plus d'un x). 


-\-x 


91 


<options de I'editeur de liens> 


Desactive I'option xpour I'editeur de liens. 


-M 


91 


Linker Map File Segment, Public, or 


Demande a I'editeur de liens de creer un fichier 






Detailed 


mappe. 


-mc 


70 


16-bit Compiler Memory Model Compact 


Compile au moyen du modele de memoire 
COMPACT (16 bits uniquement). 


-mh 


70 


16-bit Compiler Memory Model Huge 


Compile au moyen du modele de memoire HUGE 
(16 bits uniquement). 


-ml 


70 


16-bit Compiler Memory Model Large 


Compile au moyen du modele de memoire LARGE 
(16 bits uniquement). 


-mm 


70 


16-bit Compiler Memory Model Medium 


Compile au moyen du modele de memoire 
MEDIUM (16 bits uniquement). 


-mm! 


70 


16-bit Compiler Memory Model Medium 


Compile au moyen du modele de memoire 






and Never 


MEDIUM ; suppose que DS != SS (1 6 bits 
uniquement). 
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Tableau 3.1 : Recapitulatif des options (suite) 



Option 



Page Equivalent dans I'EDI 



Description 



-ms 70 1 6-bit Compiler | Memory Model | Small 

-ms! 70 16-bit Compiler | Memory Model | Small and 

Never 

-mt 70 1 6-bit Compiler | Memory Model | Tiny 

-mt! 70 16-bit Compiler | Memory Model | Tiny and 

Never 

-N 66 Compiler | Debugging | Test stack overflow 



nchemin 


60 


Directories Final 





83 


Optimizations Size Jump optimizations 


01 


81 


Optimizations Specific Executable size 


02 


81 


Optimizations Specific Executable speed 


Oa 


82 


Optimizations Specific Assume no pointer 
aliasing 


Ob 


83 


Optimizations Size Dead code elimination 


Oc 


82 


Optimizations Specific Optimize locally 


Od 


81 


Optimizations Disable all optimizations 


Oe 


84 


Optimizations Size Global register allocation 


Og 


82 


Optimizations Specific Optimize globally 


Oi 


84 


Optimizations Speed Inline intrinsic 
functions 


Ol 


83 


Optimizations Size Loop optimization 


Om 


85 


Optimizations Speed Invariant code motion 


Op 


85 


Optimizations Speed Copy propagation 


Os 


81 


Optimizations Specific Executable size 


Ot 


81 


Optimizations Specific Executable speed 


Ov 


86 


Optimizations Speed Induction variables 



-ow 



83 Optimizations | Size [ Windows prolog/epilog 



Compile au moyen du modele de memoire SMALL 

(16 bits uniquement). 

Compile au moyen du modele de memoire 

SMALL ; suppose que DS != SS (16 bits 

uniquement). 

Compile au moyen du modele de memoire TINY 

(16 bits uniquement). 

Compile au moyen du modele de memoire TINY ; 

suppose que DS != SS (16 bits uniquement). 

Verifie la presence eventuelle d'un debordement de 

pile. 

Definit le repertoire de sortie. 

Optimise les branchements. 

Genere le code le plus compact. 

Genere le code le plus rapide (identique a -Ox). 

Optimise en supposant qu'il n'existe pas d'alias 
d'expressions de pointeurs a revaluation des 
sous-expressions communes. 
Elimine le code superflu. 

Elimine les expressions dupliquees dans les blocs 

de base. 

Desactive toutes les optimisations. 

Attribue des registres globaux et analyse les zones 

de variables actives. 

Elimine les expressions dupliquees dans les 

fonctions. 

Etend les fonctions intrinseques communes en 

ligne. 

Compacte les boucles. 

Extrait le code invariable des boucles. 

Propage les copies. 

Genere le code le plus compact. 

Genere le code le plus rapide (identique a -Oxt). 

Permet I'induction de variables de boucle et la 
reduction de puissance. 

Supprime inc bp/dec bp dans les fonctions far de 
Windows (16 bits uniquement). 
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Tableau 3.1 : Recapitulatif des options (suite) 



Option 



Page Equivalent dans I'EDI 



Description 



-Ox 


81 


Optimizations Specific Speed 


-ofichier 


92 


<aucune> 


-P 


92 


<utilisez Tools> 


-Pexf 


92 


<utilisez Tools> 


-P- 


92 


<utilisez Tools> 


-P-ext 


92 


<utilisez Tools> 


-P 


69 


16-bit Compiler | Calling Convention | Pascal 


-P 


69 


32-bit Compiler Calling Convention Pascal 


-p- -pc 


69 


16-bit Compiler Calling Convention C 


-p- -pc 


69 


32-bit Compiler Calling Convention C 


-po 


63 


Compiler Code Generation FastThis 



-pr 
-pr 

-ps 

-r 
-r- 

-rd 

-R 
-RT 



69 1 6-bit Compiler | Calling Convention | Register 



69 32-bit Compiler | Calling Convention | Register 



69 32-bit Compiler | Calling Convention | 

Standard call 
64 Compiler | Code Generation | Automatic 
64 Compiler | Code Generation | None 
64 Compiler | Code Generation | Register 

keyword 
67 Compiler | Debugging [ Browser reference 

information in OBJs 

81 C++ options | Exception handling/RTTI | 
Enable RTTI 



Genere le code le plus rapide ; compatible 

Microsoft. 

Compile le fichier source pour produire un 

fichier.OBJ. 

Effectue une compilation C++, quelle que soit 

I'extension du fichier source. 

Effectue une compilation C++ et definit I'extension 

par defaut ext. 

Effectue une compilation C++ ou C selon 

I'extension du fichier source. 

Effectue une compilation C++ ou C selon 

I'extension ; definit I'extension par defaut ext. 

Utilise la convention d'appel Pascal dans les 

applications 1 6 bits (option BCC). 

Utilise la convention d'appel Pascal dans les 

applications 32 bits (option BCC32). 

Utilise la convention d'appel C (option BCC). 

Utilise la convention d'appel C (option BCC32). 

Utilise la convention d'appel fastthis pour 

transmettre le parametre this aux registres (16 bits 

uniquement). 

Utilise la convention d'appel fastcall pour 

transmettre les parametres aux registres (option 

BCC). 

Utilise la convention d'appel fastcall pour 

transmettre les parametres aux registres (option 

BCC32). 

Utilise la convention d'appel stdcall (32 bits 

uniquement). 

Utilise les variables de registre. 

Desactive I'utilisation des variables de registre. 

Seules les variables de registre declarees peuvent 
etre conservees dans les registres. 

Inclut les informations de browser dans les fichiers 
.OBJ generes. 

Active les informations de type au moment de 
I'execution. 



Chapitre 3, Compilation 



55 



Tableau 3.1 : Recapitulatif des options (suite) 



Option 



Page Equivalent dans I'EDI 



Description 



■s 


92 


<TurboMenu du gestionnaire de projeb 


■Tchaine 


90 


<utilisez Tools> 


-T- 


90 


<utilisez Tools> 


■tDc 


92 


<TargetExpert> 


■tDe 


92 


<TargetExpert> 


■tD 


92 


<TargetExpert> 


■tw 


74 


16-bit Compiler Entry/Exit Windows all 
functions exportable 


■twc 


92 


<TargetExpert> 


■tWCD 


93 


<TargetExpert> 


■tWD 


74 


16-bit Compiler | Entry/Exit [ Windows DLL, all 
funcs exported 


■tWDE 


74 


16-bit Compiler | Entry/Exit | Windows DLL, 
explicit exported 


■tWCDE 


74 


<TargetExpert> 


■tWE 


74 


16-bit Compiler Entry/Exit Windows explicit 
funcs exported 


■tWM 


93 


<TargetExpert> 


■tws 


74 


16-bit Compiler Entry/Exit Windows smart 
callbacks, all funcs 


■tWSE 


74 


16-bit Compiler Entry/Exit Windows smart 
callbacks, explicit 


■Unom 


93 


<utilisez LocalOverride dans le projet> 


■u 


65 


Compiler I Compiler Output I Generate 



underscores 
-v, -v- 67 Compiler | Debugging | Debug information in 

OBJs 



Produit un fichier de sortie .ASM. 

Transmet la chaine sous forme d'option a TASM, a 
TASM32 ou a I'assembleur specifies par -E. 
Supprime toutes les options precedentes de 
I'assembleur. 
LacibleestunfichierDOS.COM. 

La cible est un fichier DOS .EXE. 

La cible est un fichier DOS .EXE. 

La cible est un fichier Windows .EXE, toutes 
fonctions exportables. 

La cible est un fichier console .EXE, toutes 

fonctions exportables. 

La cible est un fichier console .DLL, toutes 

fonctions exportables. 

La cible est un fichier Windows .DLL, toutes 

fonctions exportables. 

La cible est un fichier Windows .DLL, fonctions 
explicites exportables. 

La cible est un fichier console .DLL, fonctions 
explicites exportables. 

La cible est un fichier Windows .EXE, fonctions 
explicites exportables. 

La cible est multithread. 

La cible est un fichier Windows .EXE utilisant des 
rappels smart (16 bits uniquement). 

La cible est un fichier Windows .EXE utilisant des 
rappels smart, fonctions explicites exportables (16 
bits uniquement). 
Annule les definitions precedentes du nom. 

Genere des caracteres de soulignement. 
Active le debogage de source. 
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Tableau 3.1 : Recapitulatif des options (suite) 



vo 


79 


V1 


79 


V 


79 


Va 


78 



Option Page Equivalent dans I'EDI 

-vi,-vi- 67 Compiler | Debugging | Out-of-line inline 

functions 

C++ Options | Virtual Tables | External 

C++ Options | Virtual Tables | Public 

C++ Options | Virtual Tables | Smart 

C++ Options | C++ Comp | Pass class values 
via reference to temp 

-Vb 78 C++ Options | C++ Compatibility | Same size 

as 'this' pointer 



78 C++ Options | C++ Compatibility | Always near 

C++ Options | C++ Compatibility | Disable 
constructor displacement 

16-bit Compiler | Memory Model | Far virtual 
tables 



Vb- 


78 


Vc 


78 


Vf 


71 


Vmd 


78 


Vmm 


78 


Vmp 


77 


Vms 


78 


Vmv 


77 


Vo 


93 


Vp 


78 


Vs 


79 


Vt 


79 



C++ Options | Member Pointer 
class 

C++ Options | Member Pointer 
multiple inheritance 
C++ Options | Member Pointer 
precision of member pointers 

C++ Options | Member Pointer 

single inheritance 

C++ Options | Member Pointer 

cases 

<aucune> 



Smallest for 



Support 



Honor 



Support 



Support all 



C++ Options | C++ Compatibility | Push "this" 
first for pascal 

C++ Options | Virtual Tables | Local 

C++ Options | C++ Comp | Vtable Pointer 
follows data members 



Description 

Controle I'expansion des fonctions en ligne. 

Tables virtuelles externes C++. 

Tables virtuelles publiques C++. 

Utilise les tables virtuelles smart C++. 

Transmet les arguments de classe par reference a 
une variable temporaire. 

Donne au pointeur de classe virtuelle de base la 

meme taille que le pointeur de classe (1 6 bits 

uniquement). 

Pointeur de classe virtuelle de base de type near 

(16 bits uniquement). 

Ne modifie pas I'agencement des classes pour 

limiter les restrictions sur les pointeurs membres 

(16 bits uniquement). 

Tables virtuelles far C++ (1 6 bits uniquement). 

Utilise la plus petite representation pour les 
pointeurs membres. 

Les pointeurs membres supportent I'heritage 
multiple. 

Respecte la precision declaree pour tous les types 
de pointeurs membres. 

Les pointeurs membres supportent I'heritage 
individuel. 

Pas de restriction sur les pointeurs membres 
(representation la plus generale). 

Active toutes les options de compatibilite 

ascendante (-Va, -Vb, -Vc, -Vp, -Vt, -Vv). 

Transmet le parametre "this" comme premier 

parametre de la pile aux fonctions membres 

"pascal". 

Tables virtuelles locales C++. 

Place le pointeur de table virtuelle apres les 
membres de donnees non statiques. 
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Tableau 3.1 : Recapitulatif des options (suite) 



Option 



Page Equivalent dans I'EDI 



Description 



-Vv 

-W 

-W 
-WD 

-WDE 

-WE 

-WM 

-ws 

-WSE 

-w! 

-w 
-w- 

-VJXXX 

-w-xxx 

-X 

-X- 



79 C++ Options | C++ Compatibility | 'deep' 
virtual bases 

74 1 6-bit Comp | Entry/Exit | Win all functions 
exportable 

92 <TargetExpert> 

74 1 6-bit Comp [ Entry/Exit | Win DLL, all 
functions exportable 

74 1 6-bit Comp [ Entry/Exit | Win DLL, explicit 
functions exported 

74 1 6-bit Comp | Entry/Exit | Windows explicit 
functions exported 

93 <TargetExpert ; cochez multithread> 

74 1 6-bit | Entry/Exit | Win smart callbacks, all 
functions exported 

74 1 6-bit | Entry/Exit | Win smart callbacks, 
explicit functions exported 

90 Make | Break Make on warnings 



87 Messages | All 

87 Messages | None 

87 Messages | Selected (voir avertissement 
specifique) 

87 Messages | Selected (voir avertissement 
specifique) 

65 Compiler | Compiler Output | Autodependency 
information (non cochee) 

65 Compiler | Compiler Output | Autodependency 
information 

80 C++ Options | Exception handling | Enable 
exceptions 



N'ajoute pas de membres caches et de code aux 
classes comportant des pointeurs vers les 
membres de classe virtuelle de base. 
La cible est un fichier Windows .EXE , toutes 
fonctions exportables. 

Cree une application GUI 32 bits lorsqu'elle est 
utilisee avec BCC32. 

La cible est un fichier Windows .DLL, toutes 
fonctions exportables. 

La cible est un fichier Windows .DLL, fonctions 
explicites exportables. 

La cible est un fichier Windows .EXE, fonctions 
explicites exportables. 

La cible est un fichier multithread Windows .EXE , 

toutes fonctions exportables. 

La cible est un fichier Windows .EXE qui utilise des 

rappels smart, toutes fonctions exportables (16 bits 

uniquement). 

La cible est un fichier Windows .EXE qui utilise des 

rappels smart, fonctions explicites exportables (16 

bits uniquement). 

Produit un code de retour different de zero a partir 

du compilateur en ligne lorsqu'il existe des 

avertissements et ne compile pas en fichier .OBJ. 

Active I'affichage d'avertissements. 

N'affiche pas les avertissements. 

Active le message d'avertissement xxx. 

Desactive le message d'avertissement xxx. 

N'utilise pas la sortie d'auto-dependance du 
compilateur. 

Utilise la sortie d'auto-dependance du compilateur. 
Active la gestion d'exceptions. 
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Tableau 3.1 : Recapitulatif des options (suite) 



Option 


Page 


Equivalent dans I'EDI 


Description 


■ -xd 


80 


C++ Options Exception handling Enable 
destructor cleanup 


Active la mise au net des destructeurs. 


-xp 


80 


C++ Options Exception handling Enable 
exception location info 


Active les informations de localisation d'exception. 


-Y 


93 


<TargetExpert DOS Overlay> 


Active la generation de code de recouvrement. 


-Yo 


67 


<editez les attributs de noeud et cochez 
Overlay this module> 


Recouvre les fichiers compiles 


-y 


67 


Compiler Debugging Line numbers 


Numeros de ligne actives. 


-z 


83 


Optimizations Size Suppress redundant 
loads 


Active le chargement de registre. 


-zAnom 


74 


16-bit Compiler | Segment Names Code | 
Code Class 


Classe de code. 


-zB nom 


73 


16-bit Compiler Segment Names Data 
Uninitialized Data Class 


Classe BSS. 


-zCnom 


74 


16-bit Compiler Segment Names Code 
Code Segment 


Segment de code. 


-zDnom 


73 


16-bit Compiler Segment Names Data 
Uninitialized Data Segment 


Segment BSS. 


-zE nom 


73 


16-bit Compiler Segment Names Far Data 
Segment 


Segment far (16 bits uniquement). 


-zFnom 


73 


16-bit Compiler Segment Names Far Data 
Class 


Classe far (16 bits uniquement). 


-zG nom 


73 


16-bit Compiler | Segment Names Data | 
Uninitialized Data Group 


Groupe BSS. 


-zHnom 


73 


16-bit Compiler Segment Names Far Data 
Group 


Groupe far (1 6 bits uniquement). 


-zPnom 


74 


16-bit Compiler Segment Names Code 
Code Group 


Groupe de code. 


-zRnom 


72 


16-bit Compiler Segment Names Data 
Initialized Segment 


Segment de donnees. 


-zSnom 


73 


16-bit Compiler Segment Names Data 
Initialized Group 


Groupe de donnees. 


-zTnom 


73 


16-bit Compiler Segment Names Data 
Initialized Class 


Classe de donnees. 


-zMnom 


73 


16-bit Compiler Segment Names Far Data 
VT Segment 


Segment virtuel far (16 bits uniquement). 



Chapitre 3, Compilation 



59 



Tableau 3.1 : Recapitulatif des options (suite) 



Option 


Page 


Equivalent dans I'EDI Description 


-zWnom 
■ -zX* 


73 

74 


16-bit Compiler Segment Names Far Data Classe virtuelle far (16 bits uniquement). 
VT Class 

<aucune> Utilise le nom par defaut pour X ; X a pour valeur 

A-H.P, R,S,T,VouW. 






■Par defaut en 16 bits et 32 bits ■ 16 Par defaut en 1 6 bits ■ 32 Par defaut en 32 bits 



Repertoires 



-\chemin L'option Include recherche les fichiers include dans les repertoires du 

chemin d'acces (lettre d'unite ou chemin d'acces d'un sous-repertoire), ainsi 
que dans les repertoires standard. La lettre d'unite est une lettre majuscule 
ou minuscule suivie du signe deux-points (:). Le repertoire est un repertoire 
ou un chemin d'acces valide. Vous pouvez utiliser plus d'une option de 
repertoire -I (I majuscule). 

-[.chemin L'option Library oblige l'editeur de liens a utiliser le fichier objet de 

demarrage COx.OBJ et les fichiers de bibliotheque Borland C++ situes dans 
le repertoire specifie. Par defaut, l'editeur de liens recherche ces fichiers 
dans le repertoire courant. 

Source designe le repertoire dans lequel le compilateur recherche le code 
source. 

Intermediate est le repertoire dans lequel le compilateur place les fichiers 
temporaires eventuellement crees. 

-nchemin L'option Final place les fichiers de sortie finalises (.OBJ, .1 ou .ASM) que le 

compilateur a cree dans le repertoire ou l'unite designee par le chemin d'acces. 

Vous pouvez specifier plusieurs repertoires en ligne de commande selon 
une des methodes suivantes : 

■ Vous pouvez specifier plusieurs entrees a la suite d'une option -L ou -I 
individuelle sur la ligne de commande en les separant par un signe 
deux-points : 

BCC.EXE -Lnomrepl; nomrep2; nomrep3 -Unci; inc2; inc3 monfich.c 
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Algorithmes de 
recherche de 
fichiers 



■ Vous pouvez entrer plus d'une option sur la ligne de commande, comme 
suit : 

BCC.EXE -Lnomrepl -Lnomrep2 -Lnomrep3 -Unci -Iinc2 -Iinc3 
monfich . c 

Vous pouvez combiner les types de listes : 

BCC.EXE -Lnomrepl; nomrep2 -Lnomrep3 -Unci; inc2 -Iinc3 
monfich . clibrary 

Si vous definissez plusieurs options -L ou -I sur la ligne de commande, le 
resultat est cumule : le compilateur consulte tous les repertoires specifies, de 
gauche a droite. L'EDI supporte egalement plusieurs repertoires de 
bibliotheque. 

Les algorithmes de recherche de fichiers include Borland C++ recherchent 
les fichiers d'en-tete specifies dans le code source en procedant de la 
maniere suivante : 

■ Si vous entrez une instruction #include <f ichier . h> dans le code 
source, Borland C++ ne recherche f ichier. h que dans les repertoires 
include specifies. 

■ Par contre, si vous entrez une instruction #include <f ichier . h> dans le 
code, Borland C++ recherche tout d'abord fichier.h dans le repertoire 
courant ; s'il n'y figure pas, Borland C++ le recherche ensuite dans les 
repertoires include specifies en ligne de commande. 

Les algorithmes de recherche de fichiers de bibliotheque sont similaires a 
ceux des fichiers include : 

■ Bibliotheques implicites : Borland C++ recherche uniquement les 
bibliotheques implicites dans les repertoires de bibliotheque specifies, 
comme l'algorithme de recherche #include "fichier.h". Les fichiers de 
bibliotheque implicites sont ceux qui sont automatiquement lies par 
Borland C++, ainsi que le fichier objet de demarrage (COx.OBJ). 

■ bibliotheques explicites : les repertoires dans lesquels Borland C++ 
recherche les bibliotheques explicites (utilisateurs) dependent de la facon 
dont vous avez specifie le nom de fichier de bibliotheque. Les fichiers de 
bibliotheque explicites sont ceux que vous specifiez en ligne de commande 
ou dans un fichier projet ; leur nom est suivi de l'extension .LIB. 
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• Si vous specifiez un nom de fichier de bibliotheque explicite, sans 
preciser l'unite ni le repertoire dans lequel il se trouve (ex. mylib . lib), 
Borland C++ recherche tout d'abord la bibliotheque en question dans le 
repertoire courant. Si elle ne s'y trouve pas, Borland C++ la recherche 
dans les repertoires de bibliotheque specifies. Cet algorithme est done 
similaire a l'algorithme de recherche utilise pour #include "fichier. h". 

• Si vous specifiez une bibliotheque utilisateur en precisant l'unite et/ou 
le repertoire dans lequel elle figure (ex. : c : perso\mabibliol .lib), 
Borland C++ recherche uniquement la bibliotheque dans le repertoire 
designe par le chemin d'acces, et non pas dans les repertoires de 
bibliotheque specifies. 



Compiler | Defines 



Les definitions de macros vous permettent de definir et d'annuler des 
macros en ligne de commande ou dans l'EDI. Les macros definies en ligne 
de commande ou dans la boite de dialogue Options Setting ont priorite sur 
celles qui sont definies dans le fichier source. Entrez les definitions de 
macros dans la boite Defines au-dessous du sujet Code Generation I 
Settings. 

-Dnom Affecte une chaine vide au nom d'identificateur specifie. Separez les macros 
par un point-virgule. 

-Dnom=chaine Affecte la chaine qui suit le signe egal au nom d'identificateur specifie. Les 
chaines ne doivent pas contenir d'espaces, ni de tabulation. Separez les 
macros par un point-virgule. 

Borland C++ vous permet de specifier plusieurs entrees #def ine en ligne de 
commande en procedant selon une des methodes suivantes : 

■ Vous pouvez preciser plusieurs entrees a la suite d'une option -D 
individuelle en les separant les unes des autres par un point-virgule : 

BCC.EXE -Dxxx;yyy=l;zzz=NO MONFICH.C 

■ Vous pouvez entrer plusieurs options -D en les separant par des espaces : 

BCC.EXE -Dxxx -Dyyy=l -Dzzz=NO MONFICH.C 

■ Vous pouvez combiner plusieurs listes -D contenant des entrees separees 
par des points-virgules : 

BCC.EXE -Dxxx -Dyyy=l; zzz=NO MONFICH.C 
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-b -b- L'option Allocate enums as ints attribue un int de deux octets (16 bits) ou 
de quatre octets (32 bits) aux types d'enumeration. Elle est activee par 
defaut. Si elle n'est pas cochee (-b-), elle attribue la plus petite taille de 
variable en mesure de contenir les valeurs d'enumeration : le compilateur 
attribue un char non signe ou signe si les valeurs d'enumeration sont 
comprises dans l'eventail de a 255 (minimum) ou de -128 a 127 
(maximum), ou un entier court non signe ou signe si les valeurs 
d'enumerotation sont comprises dans l'eventail a 65 535 (minimum) ou -32 
768 a 32 767 (maximum). Le compilateur attribue un int de deux octets (16 
bits) ou de quatre octets (32 bits) pour representer les valeurs d'enumeration 
si l'une d'entre elles se situe en dehors de l'eventail de valeurs. 

-K -K- L'option Unsigned characters traite toutes les declarations char comme s'il 
s'agissait de caracteres non signes afin d'assurer la compatibilite avec les 
autres compilateurs. Par defaut, BBC utilise des declarations char signees 
(option non cochee ou -K-). 

-d L'option Duplicate strings merged fusionne les chaines litterales 
lorsqu'une chaine est identique a une autre pour reduire la taille des 
programmes. Elle augmente toutefois la duree de compilation. Cette option 
risque de produire des erreurs lorsqu'une chaine est modifiee. Par defaut 
elle n'est pas activee (-d-). 

-po FastThis utilise la convention d'appel fastthis pour passer le pointeur 

this dans un registre aux fonctions membres. 

Lorsque fastthis est actif (applications 16 bits uniquement dans la mesure 
ou fastthis est toujours active dans les applications 32 bits), le compilateur 
compile les fonctions membres de facon a ce que leur pointeur this soit 
transmis dans un registre (ou dans une paire de registres pour les modeles 
de donnees 16 bits plus importants). De meme, les appels de fonctions 
membres chargent la valeur de this (dans le registre) ou la paire de registres. 

Vous pouvez activer fastthis au moyen de l'option de ligne de commande 
-po ou de l'option d'appel Compiler I Code Generation I FastThis. Vous 
pouvez egalement utiliser le mot-cle de specification de langage fastthis. 



Chapitre 3, Compilation 63 



Dans les modeles de donnees SMALL ou FLAT, this est fourni dans le 
registre SI ; les modeles de donnees 16 bits plus importants utilisent DS:SI. Si 
necessaire, le compilateur sauvegarde et restaure DS. Toutes les references 
aux donnees membre dans la fonction membre sont effectuees par 
l'intermediaire du registre SI. 

Le nom des fonctions membres compilees avec fastthis est transforme 
(mangled) differemment des fonctions membres non-fastthis pour eviter de 
melanger les deux. II est plus facile de compiler toutes les classes avec 
fastthis, mais vous pouvez tres bien compiler certaines classes avec fastthis 
et d'autres sans. 

-r- L'option None n' utilise pas de variables de registre. 

-rd L'option Register keyword specifie que les variables de registre ne sont 
utilisees que si vous utilisez le mot-cle de registre et qu'un registre est 
disponible. Vous pouvez utiliser -rd dans les options #pragma. Utilisez 
cette option ou l'option -r pour optimiser l'utilisation des registres. 

-r L'option Automatic utilise les variables de registre. Le compilateur affecte 
automatiquement des variables aux registres, meme lorsque vous ne 
specifiez pas de variable de registre au moyen d'un specificateur de type de 
registre. L'option -r est activee par defaut. 



Compiler|Floating Point 



-f -f- L'option No floating point (-f-) specifie que le programme ne contient 

aucun calcul en virgule flottante ; aucune bibliotheque en virgule flottante 
n'est done liee. Si cette option n'est pas cochee (-f), elle emule les appels 
80x87 au moment de l'execution. 

-ff -ff- L'option Fast floating point (-ff ) optimise les operations en virgule flottante 
sans tenir compte des conversions de type implicite ou explicite. Le temps 
de reponse est parfois plus rapide qu'en mode d'exploitation ANSI. Non 
cochee (-ff-), cette option desactive les calculs flottants rapides. Le 
compilateur suit Ides regies ANSI strictes pour la conversion des calculs en 
virgule flottante. 
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-X -X- Autodependency information (-X) genere des informations 

d'auto-dependance. Les modules compiles lorsque cette option est active 
peuvent utiliser la fonction d'auto-dependance de MAKE. Par defaut, 
l'auto-dependance est activee (-X-). 

-u L'option Generate underscores insere automatiquement un caractere de 
soulignement devant les identificateurs avant de les sauvegarder dans un 
module objet. Les caracteres de soulignement des identificateurs C et C++ 
sont optionnels, mais sont actives par defaut. Pour les desactiver, utilisez 
l'option -u-. A noter cependant que lorsque les caracteres de soulignement 
sont desactives, des erreurs de liaison se produisent au cours de la liaison 
des bibliotheques Borland C++ standard. Pour plus de details sur les 
caracteres de soulignement, consultez le chapitre 10 du Guide du 
programmeur. 

-Fc Generate COMDEFs (16 bits uniquement) genere des variables communes 
(COMDEF) pour les variables C globales qui ne sont pas initialisees, ni 
declarees statiques ou externes. L'avantage de cette option est que les 
fichiers d'en-tete qui sont inclus dans plusieurs fichiers sources peuvent 
contenir des declarations de variables globales. Tant qu'une variable donnee 
ne doit pas etre initialisee pour prendre une valeur differente de zero, vous 
n'avez pas a inclure de definition correspondante dans les fichiers sources. 
Vous pouvez utiliser cette option pour porter du code utilisant une fonction 
similaire dans une autre implementation. 



Compiler | Source 



Nested comments vous permet d'imbriquer des commentaires. Les 
commentaires ne peuvent normalement pas etre imbriques. 

Identifier length oblige le compilateur a reconnaitre uniquement les 
n premiers caracteres des noms d'identificateur. Tous les identificateurs, 
qu'il s'agisse de variables, de macros preprocesseurs ou de membres de 
structure, ne sont traites en tant qu'identificateurs distincts que si les n 
premiers caracteres sont uniques. Si vous donnez a n la valeur ou une 
valeur superieure a 249, ou si vous ne specif iez pas l'option -in, les 
identificateurs ont une longueur illimitee. 
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Par defaut, Borland C++ utilise 32 caracteres par identificateur. Les autres 
systemes, y compris certains compilateurs UNIX, ignorent les caracteres 
au-dela des huit premiers. Si le code doit etre porte dans d'autres 
environnements, il est preferable de le compiler en limitant le nombre de 
caracteres significatifs pour vous aider a localiser les conflits de noms dans 
les identificateurs relativement longs qui ont ete tronques. 

-A- -AT Borland extensions utilise les mots-cles Borland C++. Pour obtenir la liste 
complete des mots cles Borland C++, reportez-vous au chapitre 1 du Guide 
du programmeur. 

-A ANSI compile du code compatible ANSI. Les mots-cles Borland C++ sont 
ignores et peuvent etre utilises comme identificateurs normaux. 

-AU UNIX V utilise uniquement la conformite d'extension de langage UNIX. 

-AK Kernighan and Ritchie utilise uniquement la conformite de langage 
Kernighan et Ritchie. 



Compiler | Debugging 



-k Standard stack frame genere un cadre de pile standard qui est utile 
lorsqu'un debogueur est utilise pour remonter la pile de procedures 
invoquees. Cette option est active par defaut. Lorsqu'elle est desactivee, 
toute fonction qui n'utilise pas de variable locale et ne possede pas de 
parametre est compilee avec une entree et un code de retour abreges, 
rendant ainsi le code moins volumineux et plus rapide. 

-N Test Stack overflow genere une logique de debordement de pile a 1' entree 
de chaque fonction. Cette option affiche un message de debordement de pile 
en presence d'un debordement de pile a 1' execution. Elle affecte a la fois la 
taille et la vitesse du programme, mais a ete prevue parce qu'il est parfois 
tres difficile de detecter un debordement de pile. Lorsqu'un debordement 
de pile est detecte, le message Stack overflow! apparait et le programme se 
termine en produisant le code de sortie 1. 
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-vi Out-of-line inline functions etend les fonctions en ligne C++. Pour 
controler l'expansion des fonctions en ligne, l'option -V agit de maniere 
legerement differente en C++ : lorsque l'expansion de fonction en ligne n'est 
pas activee, la fonction est generee et appelee comme toute autre fonction. 
Le debogage est parfois difficile avec l'expansion en ligne, c'est pourquoi 
Borland C++ fournit les options suivantes : 

■ -V active le debogage et desactive l'expansion en ligne. Lorsque 
l'option est desactivee, vous pouvez lier des fichiers .OBJ plus 
volumineux. Cette option affecte la duree de compilation, mais pas la 
vitesse d'execution. 

■ -V- desactive le debogage et active l'expansion en ligne. 

■ -vi active l'expansion en ligne. 

■ -vi- desactive l'expansion en ligne. 

Par exemple, si vous voulez activer le debogage et l'expansion en ligne, 
vous devez utiliser -V -vi. 

-y Line numbers ajoute des numeros de ligne dans le fichier .OBJ pour le 
debogueur integre de l'EDI. Les numeros augmentent la taille du fichier 
.OBJ, mais n'affectent pas la taille, ni la vitesse du programme executable. 
Cette option est utile avec les debogueurs symboliques. En general, -V est 
plus utile que -y avec le debogueur integre. 

Les options de debogage comprennent les informations de debogage dans le 
code genere. Pour plus de details sur le debogage d'application, consultez le 
chapitre 6 ; pour plus de details sur les informations de browser, 
reportez-vous au chapitre 1 

-v Debug information in OBJs ajoute des informations de debogage aux 
fichiers .OBJ pour permettre de les deboguer au moyen du debogueur 
integre ou d'un debogueur autonome. Le compilateur transmet cette option 
a l'editeur de liens pour lui permettre d'inclure les informations de 
debogage dans le fichier .EXE. Dans le cadre du debogage, cette option traite 
les fonctions en ligne C++ comme des fonctions normales. 

-R Browser reference information in OBJs ajoute des informations de 

browser lorsque le compilateur genere les fichiers .OBJ ; ceci vous permet 
d'examiner une application au moyen du Browser integre de l'EDI. Le 
Browser est decrit au chapitre usingbc. Lorsque cette option est desactivee, 
vous pouvez lier des fichiers .OBJ plus volumineux. Cette option affecte la 
duree de compilation, mais pas la vitesse d'execution. 
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Compiler | Precompiled headers 



-H Generate and use genere et utilise des en-tetes precompiles au moyen du 
fichier par defaut BCDEF.CSM (16 bits) ou BC32DEF.CSM (32 bits) pour les 
compilateurs en ligne de commande et <nom_projet>.CSM pour les projets 
dans l'EDI. Les en-tetes precompiles peuvent accelerer sensiblement la 
vitesse de compilation, mais occupent un espace considerable sur le disque. 
Pour plus de details sur les en-tetes precompiles, voir l'annexe C. 

-Hu Use but do not generate utilise les en-tetes precompiles mais ne les genere 
pas. 

-H- Do not generate or use ne genere pas d'en-tetes precompiles et ne les 
utilise pas. 

-H=fichier Precompiled header name genere et utilise des en-tetes precompiles et 
definit le nom du fichier contenant les en-tetes precompiles (different de 
BCDEF.CSM ou BC32DEF.CSM). 

-H'xxx" Stop precompiling after header file interrompt la compilation d'en-tetes 
precompiles lorsqu'elle compile le fichier specifie par xxx. 



16-bit Compiler | Processor 



-2 80286 genere des instructions compatibles avec le mode protege 
80286 16 bits. 

-3 80386 genere des instructions compatibles avec le mode protege 
80386 16 bits. 

-4 i486 genere des instructions compatibles avec le module protege 
80486 16 bits. 

-an Data alignment Byte/Word aligne sur un octet (Byte, n = 1) ou sur un mot 

(Word, n = 2). Voir plus loin la version 32 bits de cette option. 
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Word (-a) oblige a aligner les elements a la taille d'entier et plus importants 
sur une limite de mot machine. Les octets supplementaires sont inseres dans 
une structure pour garantir l'alignement correct des membres. Les variables 
automatiques et globales sont alignees correctement. Les variables char et 
non signees et les zones peuvent etre placees a toute adresse ; toutes les 
autres variables sont placees a une adresse portant un numero pair. Byte 
(-a-) permet l'alignement d'octet. L'alignement de mot augmente la vitesse 
d'extraction et de stockage des donnees des processeurs 80x86. 



16-bit Compiler | Calling Convention 



Les conventions d'appel font l'objet d'une description plus detaillee dans le 
chapitre 2 du Guide du programmeur. 

-pc -p- C genere tous les appels de procedures et toutes les fonctions au moyen de 
la convention d'appel d'appel C, ce qui revient a declar er toutes les 

procedures et fonctions au moyen du mot-cle cdecl. Les appels de 

fonctions resultants sont plus courts et plus rapides. Les fonctions doivent 
transmettre le nombre et le type d'arguments corrects, a la difference de 
l'usage normal du C qui permet un nombre variable d'arguments de 

fonction. Vous pouvez utiliser le mot-cle cdecl, pascal ou fastcall 

pour declarer specifiquement une fonction ou une procedure d'appel au 
moyen d'une convention d'appel differente. 

-p Pascal genere tous les appels de procedures et toutes les fonctions au 

moyen de la convention d'appel Pascal, ce qui revient a declarer toutes les 

procedures et fonctions au moyen du mot-cle pascal. Les appels de 

fonctions resultants sont plus courts et plus rapides. Les fonctions doivent 
transmettre le nombre et le types d'arguments corrects. Vous pouvez utiliser 

le mot-cle cdecl, Stdcall ou fastcall pour declarer specifiquement 

une fonction ou procedure au moyen d'une autre convention d'appel. 

-pr Register genere tous les appels de procedures et toute les fonctions au 

moyen de la convention d'appel Register, ce qui revient a declarer toutes les 
procedures et fonctions au moyen du mot-cle _ _fastcall. Vous pouvez 

utiliser le mot-cle Stdcall, pascal ou cdecl pour declarer 

specifiquement une fonction ou procedure au moyen d'une convention 
d'appel differente. 
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16-bit Compiler | Memory Model 



Les options de modele de memoire vous permettent d'indiquer au 
compilateur le modele de memoire a utiliser pour compiler les applications 
16 bits (les applications 32 bits utilisent automatiquement le modele FLAT). 
Les modeles de memoire disponibles sont les suivants : SMALL, MEDIUM, 
COMPACT et LARGE. Pour plus de details sur les modeles de memoire, 
consultez le chapitre 8 du Guide du programmeur. 

-ms -ms! Small effectue la compilation au moyen du modele de memoire SMALL 
(modele par defaut). L'option en ligne de commande -ms! effectue la 
compilation au moyen du modele de memoire SMALL et suppose que DS != 
SS. Pour obtenir le meme resultat dans l'EDI, vous devez cocher deux 
options (Small et Never). 

-mm -mm! Medium effectue la compilation au moyen du modele de memoire 

MEDIUM. L'option en ligne de commande -mm! effectue la compilation au 
moyen du modele de memoire MEDIUM et suppose que DS != SS. Pour 
obtenir le meme resultat dans l'EDI, vous devez cocher deux options 
(Medium et Always). 

L'effet reel des options -mt!, -ms! et -mm! est en fait tres limite. Si vous 
utilisez l'adresse d'une variable de pile (parametre ou automatique), le 
pointeur resultant est, par defaut (DS= SS), un pointeur near (relatif a DS). 
Ceci vous permet d'affecter l'adresse a un pointeur a la taille par defaut 
dans ces modeles sans aucun probleme. Lorsque DS != SS, le type de 
pointeur cree lorsque vous utilisez l'adresse d'une variable de pile est un 
pointeur _SS. Vous pouvez done affecter ou transmettre librement le 
pointeur a un pointeur far ou _SS. Cependant, l'attribution de l'adresse a un 
pointeur near ou a la taille par defaut produit un avertissement "Suspicious 
pointer conversion" dans les modeles de memoire affectes. De tels 
avertissements representent generalement une erreur et sont done actives 
par defaut. 

-mc Compact effectue la compilation au moyen du modele de memoire 
COMPACT. 

-ml Large effectue la compilation au moyen du modele de memoire LARGE. 

-mh Huge effectue la compilation au moyen du modele de memoire HUGE . 
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-mt -mt! Tiny effectue la compilation au moyen du modele de memoire TINY. 

L'option en ligne de commande -mt compile selon le modele SMALL et 
suppose que DS != SS. Pour realiser ceci dans l'EDI, vous devez cocher deux 
options (Tiny et Never). 

Default for model determine, en fonction du modele, si le segment de pile 
est egal au segment de donnees. 

Par defaut, le modele est utilise pour determiner si le segment de pile est 
egal au segment de donnees. 

-Fs- Never suppose que le segment de donnees n'est jamais egal au segment de 
pile, quel que soit le modele de memoire utilise. 

-Fs Always suppose que le segment de donnees (DS) est egal au segment de 
pile (SS) dans tous les modeles de memoire ; vous pouvez l'utiliser pour 
porter du code developpe a l'origine pour une implementation qui integre 
la pile au segment de donnees. 

-de Put strings in code segments transfere toutes les constantes chaines du 
segment de donnees dans le segment de code du fichier objet genere pour 
dormer un type de donnees const (16 bits uniquement). Ces options 
permettent de limiter l'espace occupe par le segment de donnees. Dans les 
programmes volumineux, notamment ceux qui contiennent de nombreuses 
constantes chaines, cette option transfere le poids des constantes chaines du 
segment de donnees au segment de code. 

-Ff Automatic far data change le type des variables globales superieures ou 
egales a la taille de seuil pour en faire des variables far. La taille de seuil par 
defaut est de 32 767. Cette option est utile lorsque le code n' utilise pas le 
modele de memoire HUGE mais declare des variables globales dont la taille 
totale depasse de 64 ko (ou s'en rapproche). Cette option n'a aucun effet 
pour les modules de memoire TINY, SMALL et MEDIUM. Si vous utilisez 
cette option avec -Fc, les COMDEF generes prennent le type far dans les 
modeles COMPACT, LARGE et HUGE. 

-Vf Far virtual tables cree les tables virtuelles dans le segment de code au lieu 
du segment de donnees (sauf en cas de changement au moyen des options 
-zV et -zW) et convertit les pointeurs de table virtuelle en pointeurs 
32 bits complets (cette operation est effectuee automatiquement si vous 
utilisez le modele de memoire HUGE). 
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Cette option peut etre utilisee pour deux raisons : pour supprimer les tables 
virtuelles du segment de donnees, parce qu'il arrive a saturation par 
exemple, et pour pouvoir partager les objets (de classes avec fonctions 
virtuelles) entre les modules qui utilisent differents segments de donnees 
(par exemple, une DLL et un executable utilisant le DD en question). Pour 
tous les modules en mesure de partager des objets, vous devez effectuer la 
compilation totalement avec ou totalement sans cette option. Vous obtenez 
le meme effet en utilisant les modificateurs huge ou _export sur chaque 
classe. 

-h Fast huge pointers offre une methode alternative pour le calcul 

d'expressions pointeurs HUGE ; cette methode est beaucoup plus rapide 
que la methode standard, mais doit etre utilisee avec precaution. Lorsque 
vous utilisez cette option, les huge pointers ne sont normalises que 
lorsqu'un bouclage de segment se produit dans la partie deplacement, ce 
qui cree des problemes avec les grands tableaux lorsqu'un element du 
tableau franchit une limite de tableau. Cette option est desactivee par defaut. 

En principe, Borland C++ normalise un huge pointer lorsqu'il ajoute ou 
soustrait un element de celui-ci. Ceci permet de s'assurer que l'indexation 
dans un tableau et la selection de zones struct fonctionneront avec des 
StructS de toute taille si vous utilisez un grand tableau de struct superieur a 
64 ko par exemple. Borland C++ y parvient en normalisant toujours le 
resultat des operations pointeurs HUGE, de sorte que la partie deplacement 
contienne une valeur ne depassant pas 15 pour eviter les bouclages avec les 
huge pointers. L'inconvenient de cette methode est qu'elle tend a ralentir 
sensiblement la vitesse d'execution. Cette option est automatiquement 
selectionnee pour la compilation Windows. 

-Ff=s/ze Far Data Threshold modifie le point auquel les donnees prennent le type 
far (utilise par l'option -Ff). 

16-bit Compiler | Segment Names Data 

Ces options demandent une excellente connaissance de la segmentation sur 
les processeurs 80x86. En temps normal, vous n'avez pas a specifier les 
noms de segment. 

-zRnom Initialized Data Segment donne le nom specifie au segment de donnees 
initialise. Par defaut, le segment de donnees initialise est nomme _DATA. 
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-zSnom Initialized Data Group change le nom du groupe de segments de donnees 
initialise pour adopter le nom specifie. Par defaut, le groupe de donnees 
initialise est nomme DGROUP. 

-iTnom Initialized Data Class donne le nom specifie au segment de donnees 
initialise. Par defaut, le nom du segment initialise est DATA. 

-zDnom Uninitialized Data Segment change le nom du segment de donnees non 
initialise pour adopter le nom specifie. Par defaut, le nom du segment de 
donnees non initialise est _BSS. 

-zGnom Uninitialized Data Group change le nom du groupe de segments de 

donnees non initialise pour adopter le nom specifie. Par defaut, le nom du 
groupe de donnees est DGROUP. 

-iBnom Uninitialized Data Class change le nom de la classe de segments de 
donnees non initialisee pour adopter le nom specifie. Par defaut, les 
segments de donnees non initialises sont attribues a la classe BSS. 

16-bit Compiler | Segment Names Far Data 

-zEnom Far Data Segment change le nom du segment ou sont places les objets _ 

_far pour adopter le nom specifie. Par defaut, le nom du segment est le nom 
du fichier source suivi de _DATA. Un nom commencant par un asterisque 
(*) indique que la chaine par defaut doit etre utilisee (16 bits uniquement). 

-zHnom Far Data Group oblige le programme a placer les objets _ _far dans le 

groupe portant le nom specifie. Par defaut, les objets far ne sont pas 

places dans un groupe. Un nom commencant par un asterique (*) indique 
que la chaine par defaut doit etre utilisee (16 bits uniquement). 

-zFnom Far Data Class change le nom de la classe d'objets _ _far pour adopter le 
nom specifie. Par defaut, elle est nominee FAR_DATA. Un nom 
commencant par un asterique (*) indique que la chaine par defaut doit etre 
utilisee (16 bits uniquement). 

-zVnom Far Virtual Tables Segment donne le nom specifie au segment de table 

virtuelle far. Par defaut, les tables virtuelles sont generees dans le segment 
de code (16 bits uniquement). 

-zWnom Far Virtual Tables Class donne le nom specifie au segment de classe de 
tables virtuelles far. Par defaut, les classes de tables virtuelles far sont 
generees dans le segment CODE (16 bits uniquement). 
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16-bit Compiler | Segment Names Code 



-zCnom Code Segment change le nom du segment de code pour adopter le nom 
specifie. Par defaut, le segment de code est nomme _TEXT. 

-zPnom Code Group oblige le programme a generer des fichiers de sortie eventuels 
ayant un code de groupe pour le segment de code specifie. 

-iMom Code Class change le nom de la classe de segment de code pour adopter le 

nom par defaut. Par defaut, le segment de code est affecte a la classe CODE. 



16-bit Compiler | Entry/Exit Code 



-tw -w -wc- 



-tWE -WE$I-W 

(option 

BCC.EXE)[W];compila 

tion avec toutes les 

fonctions far 

exportables 



Les options Entry/Exit code specifient le type d'application que le 
compilateur doit creer. Pour plus de details sur la creation d'une application 
Windows, consultez le chapitre 2. 

Windows all functions exportable cree un module objet Windows dont 
toutes les fonctions peuvent etre exportees. Cette option permet de creer le 
type d'executable Windows le plus general, mais n'est pas necessairement la 
plus efficace. II s'agit de l'option par defaut (-W-). Elle genere les 
informations systeme necessaires pour chaque fonction far, que la fonction 
en ait besoin ou pas. Elle suppose que toutes les fonctions peuvent etre 
invoquees par le noyau Windows ou par d'autres modules. 

Lorsque cette option est utilisee avec une application 16 bits, elle cree un 
prologue /epilogue de fonction .EXE Windows pour toutes les fonctions far, 
puis configure celles qui seront invoquees a partir d'un autre module. Pour 
exporter veritablement l'adresse de fonction du fichier .EXE dans une .DLL, 
le code comprend un appel a MakeProcInstanceO qui transmet le pointeur 
resultant a la .DLL demandant l'adresse de la fonction. Pour pouvoir 
exporter l'adresse de fonction de la .DLL, les noms de fonction doivent etre 
inclus dans le fichier .DEF de 1' executable. 

Windows explicit functions exported cree un module objet Windows dans 
lequel seules les fonctions declarees comme _export sont exportables. 
Utilisez cette option si certaines des fonctions ne sont pas appelees par le 
noyau Windows. Windows Explicit Functions Exported fonctionne de la 
meme maniere que Windows All Functions Exportable, si ce n'est que le 
prologue/epilogue supplementaire est attribue uniquement aux fonctions 
signalees par le mot cle _export (et aux methodes des classes marquees 
.export). 
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Cette option est bien plus efficaces que Windows All Functions Exportable 
pour les applications 16 bits dans la mesure ou le temps systeme associe au 
prologue est attribue uniquement aux fonctions appelees a l'exterieur du 
module. Cette option exige toutefois que les fonctions et classes a exporter 
soient determinees a l'avance. MakeProcInstance() est quand meme utilise, 
mais aucune manipulation de fichier .DEF n'est necessaire. 

-tWS -WS Windows smart callbacks, all functions exportable (16 bits uniquement) 
cree un module objet dont les fonctions utilisent les rappels smart et sont 
toutes exportees. Cette option ne doit etre utilisee que si le compilateur peut 
supposer que DS == SS pour toutes les fonctions du module (ce qui est le cas 
dans la vaste majorite des programmes Windows et qui constitue la valeur 
par defaut pour les outils Borland). 

Cette option cree un prologue /epiloge de fonction EXE Windows pour 
toutes les fonctions "far", puis configure les fonctions appelees par un autre 
module. II n'est pas necessaire d'appeler MakeProcInstanceO, ni d'editer de 
fichier .DEF. 

-tWSE -WSE Windows smart callbacks, explicit functions exportable cree une 
application Windows 16 bits avec rappels smart et fonctions explicites 
exportees. Cette option est identique a Windows Smart Callbacks, si ce n'est 
que le prologue /epilogue supplementaire n'est attribue qu'aux fonctions 
signalees par le mot cle _export (et aux methodes de classes _export). Elle 
done bien plus efficace dans la mesure ou le temps systeme associe au 
prologue n'est affecte qu'aux fonctions appelees a l'exterieur du module. 

-tWD -WD Windows DLL, all functions exportable cree un module objet DLL dont 
toutes les fonctions sont exportables. Cette option cree un 
prologue /epilogue de fonction DLL Windows pour toutes les fonctions 'far', 
puis configure les fonctions appelees par un autre module. Pour exporter 
veritablement l'adresse de fonction du .DLL, les noms de fonction doivent 
etre inclus dans le fichier .DEF de l'executable. 
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-tWDE -WDE Windows DLL, explicit functions exported cree un module objet DLL 

dans lequel seules les fonctions marquees _export sont exportables. L'option 
The Windows DLL, Explicit Functions Exported est identique a Windows 
DLL, All Functions Exportable, mais le prologue /epilogue supplementaire 
est attribue uniquement aux fonctions signalees par le mot cle _export (et 
aux methodes de classe marquees _export). Cette option est bien plus 
efficace que Windows DLL, All Functions Exportable dans la mesure ou le 
temps systeme associe au prologue est attribue uniquement aux fonctions 
appelees a l'exterieur du module. Elle exige toutefois que les fonctions et 
classes a exporter soient determinees a l'avance. Aucune maniuplation de 
fichier .DEF n'est necesaire. 

32-bit Compiler | Processor 

-3 80386 genere des instructions compatibles avec le mode protege 80386 32 
bits. 

-4 i486 genere des instructions compatibles avec le mode protege 80486 32 bits. 

-5 Pentium genere des instructions compatibles avec le mode protege Pentium. 

-an Data alignment Byte/Word/Double word definit l'alignement selon la 

valeur n indiquee en ligne de commande. La correspondance est la suivante 
Byte (n=l) aligne sur un octet ; Word (n=2), sur un mot de deux octets ; 
Double word (n=4), sur un double mot de quatre octets. L'alignement de 
mot accelere la vitesse d'extraction et de stockage des donnees des 
processeurs 80x86. 

32-bit Compiler | Calling Convention 

Les conventions d'appel font l'objet d'une description plus detaillee dans le 
chapitre Phrase du guide de progammation. 
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-pc -p- C genere tous les appels de procedures et toutes les fonctions au moyen de 
la convention d'appel C, ce qui equivaudrait a declarer toutes les procedures 

et fonction au moyen du mot cle cdecl. Les appels de fonction qui en 

resultent sont moins volumineux et plus rapides. Les fonctions doivent 
transmettre le nombre et le type d'arguments corrects, a la difference de 
l'usage normal du C qui permet un nombre variable d'arguments de 

fonction. Vous pouvez utiliser le mot cle cdecl, pascal, stdcall ou 

fastcall pour declarer specifiquement une fonction ou procedure au 

moyen d'une autre convention d'appel. 

-p Pascal genere tous les appels de procedures et toutes les fonctions au 

moyen de convention d'appel Pascal, ce qui equivaudrait a declarer toutes 

les procedures et fonctions au moyen du mot cle pascal. Les appels de 

fonction resultant sont moins volumineux et plus rapides. Les fonctions 
doivent transmettre le nombre et le type d'arguments corrects. Vous pouvez 

utiliser le mot cle cdecl, stdcall ou fastcall pour declarer 

specifiquement une fonction ou procedure au moyen d'une autre 
convention d'appel. 

-pr Register genere tous les appels de procedures et toutes les fonctions au 
moyen de la convention d'appel Register, ce qui equivaudrait a declarer 

toutes les procedures et fonctions au moyen du mot cle fastcall. Vous 

pouvez utiliser le mot cle stdcall, pascal, fastcall ou cdecl pour 

declarer specifiquement une fonction ou procedure au moyen d'une autre 
convention d'appel. 

-ps Standard call utilise les conventions d'appel stdcall. Cette option indique 
au compilateur d'utiliser l'ordre Pascal pour empiler les parametres. Les 
parametres sont empiles de gauche a droite. 

C++ Options | Member Pointer 

-Vmp Honor precision of member pointers utilise la precision declaree pour les 
types de pointeurs membres. Cette option doit etre utilisee lorsqu'un 
pointeur de classe derivee est explicitement classe comme pointeur membre 
d'une classe de base plus simple (lorsque le pointeur designe en fait un 
membre de classe derivee). 

-Vmv Support all cases permet aux pointeurs membres de designer tout 

membre. Les pointeurs membres utilisent la representation la plus generale 
(qui n'est pas toujours la plus efficace). 
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-Vmm Support multiple inheritance permet aux pointeurs de membre de 

designer les membres de classes d'heritage multiple, sauf les membres des 
classes virtuelles de base. 

-Vms Support single inheritance permet aux pointeurs de membre de designer 
des membres de classes d'heritage individuel uniquement. 

-Vmd Smallest for class utilise la plus petite representation qui permet aux 
pointeurs de membres de designer tous les membres de leur classe. Si la 
classe n'est pas totalement definie au point ou le type de pointeur membre 
est declare, le compilateur choisit la representation la plus generale (en 
generant un avertissement). 

C++ Options | C++ Compatibility 

-K2 Allow only two character types traite char tel qu'il est signe. Compatibilite 
avec be 3.1 et les versions precedentes (16 bits uniquement). 

-Vb-$lclasse de Always near enregistre un pointeur cache near. Lorsqu'une classe herite 

base virtuellement d'une classe de base, le compilateur enregistre un pointeur 

virtuellepointeur cache dans l'objet de classe pour acceder au sous-objet de classe virtuelle de 

cache base. Cette option genere un code moins volumineux et plus rapide. 

-Vb Same size as 'this' pointer donne au pointeur cache la taille du pointeur 
utilise par la classe proprement dite. 

-Va Pass class values via reference to temporary. Lorsqu'une classe de types 
d'arguments avec constructeurs est transmise a une fonction par une valeur, 
cette option demande au compilateur de creer une variable temporaire au 
site appelant, d'initialiser cette variable temporaire selon la valeur de 
l'argument et de transmettre a la fonction une reference a cette variable 
temporaire. 

-Vc Disable constructor displacements. Lorsque cette option est active, le 

compilateur n'ajoute pas de membre cache et de code a une classe derivee 
(valeur par defaut). Cette option permet d'assurer la compatibilite avec les 
versions precedentes du compilateur. 

-Vp Push 'this' first for Pascal member functions demande au compilateur 
de transmettre le pointeur 'this' aux fonctions membres 'pascal' en tant que 
premier parametre de la pile. Par defaut, le compilateur transmet le 
parametre 'this' comme dernier parametre de la pile. 
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-Vv "deep" virtual bases. Lorsqu'une classe derivee a priorite sur une fonction 
virtuelle dont elle herite de la classe virtuelle de base, et qu'un constructeur 
ou destructeur de la classe derivee appelle cette fonction virtuelle au moyen 
d'un pointeur vers la classe virtuelle de base, le compilateur peut parfois 
ajouter des membres caches a la classe derivee et ajouter du code a ses 
constructeurs et destructeurs. Cette option demande au compilateur de ne 
pas ajouter de membre cache, ni de code, pour que l'agencement d'instance 
de classe soit le meme que celui des versions precedentes de Borland C++. 

-Vt Virtual table pointer follows data members place le pointeur de table 
virtuelle apres les membres de donnees non statiques de la classe 
particuliere, pour assurer la compatibilite lorsque les instances de classe sont 
partagees avec un code autre que C++ et lors du partage de classes avec du 
code compile par une version precedente de Borland C++. 



C++ Options | Virtual Tables 



L'option -Vn controle les tables virtuelles C++. Elle peut s'utiliser de cinq 
facons differentes : 

-V Smart genere les tables virtuelles les plus communes en C++ et les fonctions 
inline definies hors ligne dans les modules de l'application. En consequence, 
seule une instance de table virtuelle donnee ou d'une fonction inline definie 
hors ligne est incluse dans le programme pour produire des fichiers 
executables moins volumineux et plus rapides. lis n'utilisent cependant que 
les extensions .OBJ et .ASM disponibles dans TLINK et TASM. 

-Vs Local genere des tables virtuelles locales et des fonctions inline definies 
hors ligne. En resultat, chaque module possede sa propre copie des tables 
virtuelles et fonctions inline definies hors ligne qu'il utilise. Cette option 
produit dont des executables plus volumineux que l'option Smart. 

-V0 External cree des references externes aux tables virtuelles. Si vous ne voulez 
pas utiliser l'option Smart ou Local, vous pouvez choisir External et Public 
pour produire des tables virtuelles globales et les referencer. 

-V1 Public produit des definitions publiques de tables virtuelles. Lorsque vous 
utilisez l'option External ou Public, au moins un des modules du 
programme doit etre compile avec l'option Public pour fournir les 
definitions des tables virtuelles. Tous les autres modules doivent etre 
compiles au moyen de l'option -V0 pour faire reference a la copie publique 
des tables virtuelles. 
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C++ Options | Templates 



Pour plus de details sur les modeles, consultez le chapitre plus dans le Guide 
de progr animation. 

-Jg Smart genere des definitions publiques de toutes les instances de modele. Si 
plus d'un module genere la meme intance de modele, l'editeur de liens les 
fusionne pour produire une seule copie de l'instance. Pour generer des 
instances, le compilateur doit cependant disposer du corps de la fonction 
(dans le cas d'une fonction de modele) ou du corps des fonctions membres 
et des definitions pour les membres de donnees statiques (dans le cas d'une 
classe de modeles). 

-Jgd Global genere des definitions publiques pour toutes les instances de modele 
rencon trees. Les instances dupliquees ne sont pas fusionnees, obligeant ainsi 
l'editeur de liens a signaler des erreurs de redefinition de symbole public si 
plus d'un module definit la meme instance de modele. 

-Jgx External genere les references externes aux instances de modele. Verifiez 
que les instances sont definies publiquement dans un autre module (au 
moyen de l'option -Jgd), de sorte que les references externes soient 
correctement resolues. 



C++ Options | Exception handling/RTTI 



-x Enable exceptions permet la gestion des exceptions C++. Si vous utilisez 
les constructions de gestion d'exceptions C++ dans le code et que vous 
compilez avec cette option desactivee (en annulant la coche de l'option dans 
l'EDI ou en utilisant l'option en ligne de commande -X-), une erreur se 
produit. 

-xp Enable exception location information fournit une identification des 

exceptions au moment de l'execution en fournissant les numeros de ligne ou 
se produisent les exceptions dans le code source. Ceci permet au 
programme d'interroger le fichier et le numero de ligne auquel l'exception 
C++ s'est produite. 
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-xd Enable destructor cleanup. Des destructeurs sont appeles pour tous les 
objets declares automatiquement dans la portee des instructions catch et 
throw lorsqu'une exception est rejetee. Notez que les destructeurs ne sont 
pas appeles automatiquement pour les objets dynamiques et que les objets 
dynamiques ne sont pas liberes automatiquement. 

-RT Enable runtime type information genere le code qui permet l'identification 
de type au moment de l'execution. 



Optimisations 



Le compilateur Borland contient un optimiseur permettant d'accelerer une 
application ou de reduire sa taille. La compilation ne prend que 50 % plus 
longtemps et 20 % de plus pour l'optimisation de taille. Vous effectuez une 
compilation avec optimisation a tout moment pendant le cycle du projet. Au 
debogage, la compilation avec optimisation aide parfois a reveler des 
bogues dans le code (le debogueur integre fonctionne avec le code optimise). 

-Od Disable all optimizations desactive toutes les optimisations. Vous pouvez 
dormer aux options du gestionnaire de projet la priorite sur cette option. 



Optimizations | Specific 



-02 -Ot -Ox -G Executable speed cree un code plus rapide. Le compilateur determine s'il 
peut generer le code en toute securite pour executer une instruction rep 
movsw, au lieu d'appeler une fonction d'aide pour effectuer la copie. II 
produit ainsi des copies de structures plus rapides pour les structures et 
unions de plus de huit octets qu'avec l'appel de fonction d'aide. L' option en 
ligne de commande -Ox a ete ajoutee pour la compatibilite avec le 
compilateur Microsoft. 

-01 -0s -G- Executable size cree le code le plus compact en examinant le contenu du 
code genere pour identifier les sequences dupliquees. Lorsque de telles 
sequences le permettent, l'optimiseur remplace une sequence de code par 
un branchement a la sequence identique et elimine la premiere partie du 
code. Cette situation se produit le plus souvent avec les instructions switch. 
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No optimization inhibe l'optimisation des sous-expressions communes. 
Cette option est activee par defaut. Le fonctionnement par defaut des 
compilateurs en ligne de commande ne comprend pas ce type 
d'optimisation. II n'y a done pas d'option en ligne de commande 
equivalente : il vous suffit de ne rien indiquer. 

-Oc Optimize locally elimine les sous-expressions communes dans un groupe 
d'instructions non interrompues par des branchements (blocs de base). 

-Og Optimize globally elimine les expressions dupliquees dans la portee cible et 
enregistre immediatement la valeur calculee de ces expressions (au lieu de 
recalculer les expressions). Bien qu'en theorie, cette optimisation soit de 
nature a reduire la longueur du code, elle effectue en fait une optimisation 
de la vitesse et reduit rarement la taille du code. Utilisez cette option si vous 
preferez reemployer les expressions au lieu de les recalculer pour chaque 
instance. 

-Oa Assume no pointer aliasing affecte la facon dont l'optimiseur effectue 

l'elimination des sous-expressions communes et la propagation des copies 
en permettant a l'utilisateur de conserver des informations de propagation 
des copies a travers les appels de fonction et de conserver des informations 
de sous-expressions communes a travers certains registres. Sans cette 
option, l'optimiseur doit supprimer les informations sur les copies et les 
sous-expressions. Le crenelage de pointeur risque d'introduire des bugs 
difficiles a reperer et n'est done applique que lorsque vous utilisez -Oa. 

-Oa determine comment l'optimiseur doit traiter les expressions designees 
par les pointeurs. En compliant des sous-expressions communes lorsque -Oa 
est active, l'optimiseur reconnait *p * x comme sous-expression 
commune dans la fonction fund . 

int g, y; 

int fund (int *p) 

{ 

int x=5; 

y = *p * x; 

g = 3; 

return (*p * x) ; 
} 

void func2 (void) 
{ 

g=2; 

fund (&g) ; // Correct-1' affectation g = 3 
// invalide 1' expression *p * x 
} 
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Optimizations | Size 



-O Jump optimizations optimise les branchements. Lorsque l'option Jump 
Optimization est active, le compilateur reduit la taille du code en eliminant 
les branchements redondants et reorganise les instructions de boucles et de 
switch. Lorsque cette option est active, les sequences de trace normal et 
approfondi dans le debogueur peuvent prefer a confusion dans la mesure 
ou plusieurs lignes du code source peuvent etre associees a une sequence de 
code generee. En desactivant cette option, vous obtiendrez de meilleurs 
resultats de trace au debogage. 

-01 Loop optimization exploite les instructions de deplacement de chaines des 
processeurs 80x86 en remplacant le code d'une boucle par une instruction 
de deplacement de chaine pour accelerer le code. 

int v[100] ; 
void t (void) 
{ 

int i; 

for (i = 0; i 100; i++) 
v[i] = 0; 
} 

Selon la complexite des operandes, le code de boucle compacte est parfois 
plus court que la boucle non compactee correspondante. 

-Z Suppress redundant loads supprime les chargements redondants. Cette 
option, qui optimise a la fois la vitesse d'execution et la taille de l'application 
en prenant note des valeurs chargees dans les registres, doit etre utilisee 
pour compiler avec optimisation. Les valeurs figurant deja dans un registre 
ne sont pas rechargees. 

-Ob Dead-code elimination revele des variables qui ne sont pas toujours 

necessaires. Comme l'optimiseur doit determiner ou les variables ne sont 
plus utilisees et ou leur valeur est necessaire (analyse de zone active), vous 
devez utiliser l'allocation de registre global (-Oe) avec -Ob. 

-0W Windows prolog/epilog supprime le inc bp / dec bp d'un code de prologue 
et d'epilogue de fonction far Windows. Si les informations de deboguage 
sont activees dans l'option OBJs (-v), cette option est desactivee parce que 
certains outils de debogage (comme WinSpector et Turbo Debugger pour 
Windows) ont besoin de inc bp/dec bp pour afficher les informations de 
cadre de pile. 
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-Oe Global register allocation, que vous devez toujours utiliser en optimisant 
le code, accelere la vitesse d'execution et reduit la taille de l'application. 
Lorsque l'option d'allocation de registre est active, l'allocation de registre 
global et l'analyse de zone active variable sont egalement actives. 



Optimizations | Speed 



-Oi Inline intrinsic functions genere le code pour les fonctions de memoire 
(comme strcpy ou memcmp) dans la portee de votre fonction, eliminant 
ainsi la necessite d'un appel de fonction. Le code resultant est s'execute plus 
rapidement, mais est aussi plus volumineux. Les fonctions suivantes sont 
affectees par un traitement inline avec cette option : 



alloca 


■ memset 


■ strchr 


■ strncmp 


fabs 


■ rotl 


■ strcmp 


■ strncpy 


memchr 


■ rotr 


■ strcpy 


■ strnset 


memcmp 


■ stpcpy 


■ strlen 


■ strrchr 


memcpy 


■ strcat 


■ strncat 





Vous pouvez determiner si les fonctions sont inline ou non au moyen du 
pragma intrinsic. A titre d'exemple, #pragma intrinsic strcpy 
genere le code inline de tous les appels Strcpy suivants dans la fonction, 
tandis que #pragma intrinsic -strcpy empeche le compilateur 
d'effectuer un inline pour strcpy. L' utilisation de ces pragmas dans un 
fichier a priorite sur les options du compilateur. 

Lors d'un traitement inline des fonctions intrinseques, vous devez inclure 
un prototype pour la fonction avant de l'utiliser. En effet, le compilateur 
cree une macro qui renomme la fonction inline en une fonction que le 
compilateur reconnait en interne. Dans l'exemple precedent, le compilateur 
cree la macro #define strcpy _ _strcpy_ _. 

Le compilateur reconnait les appels de function avec deux caracteres de 
soulignement a gauche et deux caracteres de soulignement a droite et essaie 
de faire correspondre le prototype de la fonction a son propre prototype 
interne. Si vous ne fournissez pas de prototype, ou si le prototype fourni ne 
correspond pas au prototype du compilateur, le compilateur rejette la 
tentative de traitement inline de la fonction et genere une erreur. 
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-Om Invariant code motion extrait le code invariable des boucles pour optimiser 
la vitesse d'execution. L'optimiseur utilise les informations au sujet de 
toutes les expressions de la fonction qui ont ete rassemblees pendant 
l'elimination des sous-expressions communes pour determiner les 
expressions dont la valeur ne change pas dans une boucle. Pour eviter de 
repeter un calcul a plusieurs reprises dans la boucle, l'optimiseur extrait le 
code de la boucle afin qu'il ne soit calcule qu'une seule fois. L'optimiseur 
reutilise ensuite la valeur calculee a l'interieur de la boucle. Vous devez 
utiliser l'extraction de code invariable de boucle a chaque fois que vous 
compilez pour optimiser la vitesse d'execution et que vous avez utilise des 
sous-expressions communes globales. En effet, en extrayant le code des 
boucles, il est possible d'obtenir une amelioration considerable de la vitesse 
d'execution. Dans le code suivant, par exemple, l'expression x * y * z 
est evaluee a chaque tour de boucle : 

int v[10] ; 
void f (void) 
{ 

int i,x,y,z; 

for (i = 0; i 10; i++) 
v [ i ] = x * y * z ; 
} 

L'optimiseur reecrit le code de la maniere suivante : 

int v[10] ; 
void f (void) 
{ 

int i, x, y, z, tl; 

tl=x*y*z; 

for (i = 0; i 10; i++) 
v[i] = tl; 
} 

-Op Copy propagation serf principalement a optimiser la vitesse d'execution, 
mais n'augmente jamais la taille du code. Comme l'extraction de code 
invariable de boucle, la propagation de copie se fie a l'analyse executee 
pendant l'elimination des sous-expressions communes. Grace a la 
propagation de copie, l'optimiseur memorise la valeur des expressions 
attribuees. Les copies des constantes, expressions et variables peuvent etre 
propagees. 
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-Ov Induction variables cree les variables d'induction et execute la reduction de 
puissance pour optimiser la vitesse d'execution des boucles. Elle doit etre 
utilisee lorsqu'une application est compilee pour accelerer sa vitesse 
d'application et que le code associe contient des boucles. L'optimiseur fait 
appel a l'induction pour creer de nouvelles variables (variables d'induction) a 
partir des expressions utilisees dans les boucles. L'optimiseur s'assure que 
les operations effectuees sur ces nouvelles variables utilisent moins de 
temps systeme (puissance reduite) que sur les variables d'origine. 

Les optimisations sont communes lorsque vous utilisez une indexation a 
l'interieur des boucles, dans la mesure ou une operation de multiplication 
est necessaire pour calculer la position indiquee par l'index dans un tableau. 
Dans le code suivant par exemple, l'optimiseur cree une variable 
d'induction a partir de l'operation parce que celle-ci demande une 
multiplication, ce qui evite aussi de conserver la valeur de i : 

int v[10] ; 
void f (void) 
{ 

int i, x,y, z; 

for (i = 0; i 10; i++) 
v [ i ] = x * y * z; 
} 

Lorsque les variables d'induction sont actives, le code change comme suit : 

int v[10] ; 
void f (void) 
{ 

int i,x,y,z, *p; 

for (p = v; p &v[10]; p++) 
*p = x * y * z ; 
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Messages 



Les messages actives par defaut sont signales par un asterisque a cote de la 
ligne de commande ; ces options sont cochees dans l'EDI. 

-w All affiche tous les messages d'avertissement. 

-wxxx -w-xxx Selected active le message d'avertissement specifique entre en ligne de 
commande ou coche dans l'EDI. Si le pragma warn est utilise dans le code 
source, il a priorite sur les options de message definies en ligne de 
commande ou dans l'EDI. Pour plus de details sur les pragmas, voir le 
chapitre 5 du Guide du programmeur. 

-w- None n'affiche pas les messages d'avertissement, mais les erreurs sont 
quand meme signalees. 

-gn Stop after n warnings interrompt la compilation au bout de 
n avertissements dans le projet. 

-jn Stop after n errors interrompt la compilation au bout de n erreurs dans le 
projet. 

Messages | Portability 

-wrpt* Nonportable pointer conversion. 

-wept* Nonportable pointer comparison. 

-wrng* Constant out of range in comparison, 

-wcln Constant is long. 

-wsig Conversion may lose significant digits, 

-wucp Mixing pointers to different 'char' types. 

Messages | ANSI Violations 

-wvoi* Void functions may not return a value. 

-wret* Both return and return with a value used. 

-wsus* Suspicious pointer conversion. 

-wstu* Undefined structure structure. 
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-wdup* Redefinition of macro is not identical. 

-wbig* Hexadecimal value contains more than 3 digits. 

-wbbf Bit fields must be signed or unsigned int. 

-wext* Identificateur is declared as both external and static, 

-wdpu* Declare type prior to use in prototype, 

-wzdi* Division by zero. 

-wbei* Initializing identificateur with identificateur. 

-wpin Initialization is only partially bracketed, 

-wnak Non-ANSI keyword used: mot. 

Messages | Obsolete C++ 

-wobi* Base initialization without a class name is now obsolete. 

-wofp* Style of function definition is now obsolete. 

-wpre* Overloaded prefix operator used as a postfix operator. 

Messages | Potential C++ Errors 

-wnci* Constant member identificateur is not initialized. 

-weas* Assigning type to enumeration. 

-whid* Fonctionl hides virtual function fonctionl. 

-wncf* Non-const function fonction called for const object. 

-wibc* Base class basel is also a base class of base2. 

-wdsz* Array size for 'delete' ignored. 

-wnst* Use qualified name to access nested type type. 

-whch* Handler for xxx is hidden by previous handler for yyy. 

-wmpc* Conversion to type will fail for members of virtual base base. 

-wmpd* Maximum precision used for member pointer type type. 
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-wntd* Use '> > ' for nested templates instead of '»'. 

-wncf* Non-volatile function fonction called for volatile object. 



Messages | Inefficient C++ Coding 



-winl* Functions containing identificateur are not expanded inline. 

-wlin* Temporary used to initialize identificateur. 

-wive* Temporary used for parameter in call to identificateur. 



Messages | Potential errors 



-wpia* Possibly incorrect assignment. 

-wdef Possible use of identificateur before definition. 

-wnod No declaration for function fonction. 

-wpro* Call to function with no prototype. 

-wrvl* Function should return a value. 

-wamb Ambiguous operators need parentheses, 

-wccc* Condition is always true/false. 

Messages | Inefficient Coding 

-waus* Identificateur is assigned a value that is never used, 

-wpar* Parameter identificateur is never used, 

-wuse Identificateur is declared but never used. 

-wstv Structure passed by value. 

-wrch* Unreachable code. 

-weff Code has no effect. 
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Messages | General 



-wasm Unknown assembler instruction. 

-will* Ill-formed pragma, 

-wias* Array variable variable is near, 

-wamp Superfluous & with function, 

-wobs* Identificateur is obsolete. 

-wpch* Cannot create precompiled header: en-tete. 



Make 



-w! Break Make on warnings renvoie un code de retour different de zero a 
partir du compilateur en ligne de commande lorsqu'il y a des 
avertissements et ne cree pas de fichiers .OBJ compiles. 



Options en ligne de commande 



Les options enumerees ci-dessous ne peuvent etre utilisees qu'avec les 
compilateurs en ligne de commande (BCC.EXE et BCC32.EXE). II n'existe 
pas d'options directement equivalentes dans l'EDI ; cependant, comme la 
plupart des ces taches peuvent etre effectuees dans l'EDI, chaque option 
contient des instructions pour l'EDI. 

-1 Genere des instructions 80186 etendues, et des programmes 80286 
executables en mode reel. 

-B Compile en assembleur et appelle TASM pour assembler le code. Si vous ne 
possedez pas TASM, cette option genere une erreur. En outre, les anciennes 
versions de TASM risquent de poser des problemes avec le code 32 bits. 

-c Compile et assemble les fichiers .C, .CPP et ASM specifies, mais n'execute 
pas de commande d'edition de liens. Choisissez l'option Project I Compile 
dans l'EDI. 
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-efichier Derive le nom du programme executable du nom defichier specifie et lui 
ajoute l'extension defichier .EXE (le nom de programme est alors 
fichier.EXE). Le nom de fichier doit suivre immediatement l'option -e, sans 
espace intermediate. Sans cette option, l'editeur de liens derive le nom du 
fichier .EXE du nom du premier fichier source ou objet dans la liste de noms 
de fichier. 

-Efichier Fichier est le nom de l'assembleur a utiliser, par defaut TASM. Dans l'EDI, 
vous pouvez ajouter un outil pour le programme assembleur a utiliser. Pour 
plus de details sur l'addition d'outils dans l'EDI, reportez-vous au chapitre 2. 

-f87 Utilise des instructions pour materiel 8087 (DOS 16 bits uniquement) 

-f287 Utilise des instructions pour materiel 80287 (DOS 16 bits uniquement). Dans 
l'EDI, cochez l'option Fast floating point de TargetExpert lorsque vous creez 
une cible DOS 

-Fm Cette option active toutes les autres options -F (-Fc, -Ff et -Fs). Elle 
constitue un raccourci pratique pour porter du code a partir d'autres 
compilateurs. Pour obtenir le meme resultat dans l'EDI, cochez les options 
de -Fc, -Ff et -Fs. 

-He En-tetes precompiled de cache. Cette option doit etre utilisee avec -H ou 
-Hxxx. Elle est utile lorsque la compilation se fait sur plus d'un en-tete 
precompiled 

-Ix Transmet l'option x a l'editeur de liens (TLINK pour BCC et TLINK32 pour 
BCC32). Plus d'une option peut etre precisee apres -I (L minuscule). Pour 
selectionner les options d'editeur de liens dans l'EDI, choisissez Options I 
Project I Linker. Pour obtenir la liste des options d'editeur de liens, 
reportez-vous au chapitre 9. 

-\-x Supprime l'option x de l'editeur de lien. Plus d'une option peut etre precisee 
apres le -I- (L minuscule suivi d'un tiret). Vous pouvez cocher et annuler les 
options de l'editeur de liens dans l'EDI en selectionnant Options I Project I 
Linker. 

-M Oblige l'editeur de liens a produire une table de liaison complete. Par 
defaut, il ne produit pas de table de liaison. Dans l'EDI, cochez Segment, 
Public ou Detailed dans la partie Linker I MapFile de la boite de dialogue 
Project Options. 

-ofichier Compile le fichier specifie pour produire fichier. ob). 
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-P- Compile les fichiers ayant l'extension .CPP en tant que fichiers C++ ; les 
autres fichiers sont compiles en tant que fichiers C. Dans l'EDI, utilisez des 
outils differents pour compiler un noeud de projet. Pour plus de details, 
reportez-vous au chapitre 2. 

-P Compile tous les fichiers en tant que fichiers C++, quelle que soit leur 

extension. Dans l'EDI, utilisez des outils differents pour compiler un noeud 
de projet. Pour plus de details, reportez-vous au chapitre 2. 

-Pext Compile tous les fichiers en tant que fichiers C++ ; cette option modifie 
l'extension par defaut pour utiliser l'extension specifiee Cette option est 
disponible parce que certains programmeurs utilisent .C ou toute autre 
extension comme extension par defaut dans le code C++. Dans l'EDI, 
utilisez des outils differents pour compiler un noeud de projet. Pour plus de 
details, reportez-vous au chapitre 2. 

-P-ext Effectue la compilation en fonction de l'extension (.CPP pour le code C++, 
tout autre extension de nom de fichier pour code code C) et definit 
l'extension par defaut (autre que .CPP). Dans l'EDI, utilisez des outils 
differents pour compiler un noeud de projet. Pour plus de details, 
reportez-vous au chapitre 2. 

-S Cette option compile les fichiers source specifies et produit des fichiers de 
sortie en langage assembleur (.ASM), mais n' effectue pas l'assemblage 
proprement dit. Lorsque vous utilisez cette option, Borland C++ inclut les 
lignes source C ou C++ comme commentaires dans le fichier .ASM produit. 
Dans l'EDI, utilisez differents outils pour compiler un noeud de projet. 
Selectionnez Special I C++ to Assembler dans le TurboMenu de la fenetre 
projet. Pour plus de details, reportez-vous au chapitre 2. 

-Tchaine Passe une chaine sous forme d'option a TASM (ou une option a l'assembleur 
defini par l'option -E). 

-T- Supprime toutes les options d'assembleur definies precedemment. 

-tD -De Cree un fichier .EXE 16 bits pour DOS. Dans l'EDI, choisissez ce type de 
cible lorsque vous creez la cible de votre projet. 

-tDc Cree un fichier .COM 16 bits pour DOS. L'EDI ne permet pas de creer ce 
type de fichiers 

-tWC -WC Cree une application en mode console 32 bits. Dans l'EDI, selectionnez ce 
type de cible pour creer une cible de projet. 

-tW -W Cree une application GUI 32 bits. Dans l'EDI, selectionnez ce type de cible 
pour creer une cible de projet. 
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-tWCD -WCD Cree une DLL de mode console 32 bits avec toutes les fonctions exportees. 
Dans l'EDI, selectionnez ce type de cible pour creer une cible de projet. 

-tWCDE -WCDE Cree une DLL en mode console 32 bits avec fonctions explicites exportees. 
Dans l'EDI, selectionnez ce type de cible en creant une cible de projet. 

-tWD -WD Cree une DLL GUI 32 bits avec toutes les fonctions exportables. Dans l'EDI, 
selectionnez ce type de cible pour creer une cible de projet. 

-tWDE -WDE Cree une DLL GUI 32 bits avec fonctions explicites exportables. Dans l'EDI, 
selectionnez ce type de cible pour creer une cible de projet. 

-WM Cree une application ou une DLL multithread. Utilisez cette option avec 

-Wm et -WCD. Dans l'EDI, selectionnez ce type de cible pour creer une cible 
de projet. 

Unom Annule toute definition de l'identificateur specifie. 

-Vo Cette option active toutes les options de compatibilite ascendante 

repertoriees dans cette section. Elle constitue un raccourci pratique pour lier 
les bibliotheques creees au moyen d'une version plus ancienne de 
Borland C++. 

-Y Permet la generation du code de recouvrement. Dans l'EDI, choisissez 

DOS Overlay comme type de cible lorsque vous creez une cible pour votre 
projet. 

Yo Demande le recouvrement des fichiers compiles. Dans l'EDI, cochez Overlay 
this module dans la boite de dialogue Node Attribute pour tous les noeuds 
rattaches a une cible DOS Overlay (-Y). 

-zX* Utilise le nom par defaut de X. Par exemple, -zA* attribue le nom de classe 
par defaut CODE a la classe de segments de code. 
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Creation d'applications avec 
AppExpert 



Reportez-vous au 

chapitre 5 ou a I'aide 

en ligne pour plus de 

renseignements sur 

AppExpert. 



Ce chapitre vous explique comment utiliser AppExpert pour creer des 
applications Windows a partir d'ObjectWindows 2.0. Exploitant les classes 
de Resource Workshop et d'ObjectWindows 2.0 ainsi que le gestionnaire de 
projet de l'EDI, AppExpert permet une approche visuelle de la generation 
d'applications. Familiarisez-vous avec ces elements pour une utilisation 
optimale d' AppExpert. 

AppExpert vous permet de creer un fichier Windows executable avec des 
fonctions du type barre d'icones, barre d'etat, menus, aide en ligne et 
fenetres MDI. Vous pouvez aussi selectionner des options pour 
implementer les fonctions d'impression, d'apercu avant impression et de 
Document/ View. 



Notions de base sur AppExpert 



La creation d'applications avec AppExpert s'effectue en quatre temps : 

1. Utilisez ClassExpert pour definir l'interface utilisateur et les fonctions de 
l'application, ainsi que pour generer le code. 

2. Utilisez ClassExpert pour ajouter des classes et des gestionnaires 
d'evenements, pour implementer des fonctions virtuelles et pour 
explorer le code source des classes existantes. ClassExpert peut 
egalement associer des objets crees avec Resource Workshop a des 
classes ou des gestionnaires. Utilisez ClassExpert si vous avez des 
problemes de gestion d'evenements, d'implementation de fonctions 
virtuelles et de variables modeles. 

3. Utilisez Resource Workshop pour modifier ou ajouter des ressources. 

4. Utilisez le gestionnaire de projet pour creer le fichier executable. 
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AppExpert cree obligatoirement les fichiers suivants pour chaque 
application : 

AppExpert cree un ■ Un fichier de projet (.IDE) 

fichier .APX contenant T T c - u ■ • • 1 / r^nn\ 

des informations " Un flchler source P^apal (.CPP) 

importantes qui seront ■ Un fichier d'en-tete principal (.H) 

ClassExpert ■ ^ n fichier script de ressource (.RC) 

■ Un fichier d'en-tete de ressource (.RH) 

■ Un fichier de base de donnees pour le programme AppExpert source 
(.APX) 

Selon les options choisies, AppExpert peut creer les fichiers suivants : 

■ des fichiers d'aide source (.RTF) 

■ un fichier de projet d'aide (.HPJ). 

■ des fichiers d'icones et de bitmap (.ICO et .BMP) 

Creation d'une application avec AppExpert 

Cette section vous explique comment creer une application AppExpert. 

1. Lancez l'EDI et selectionnez Project I AppExpert. Une boite de dialogue 
apparait. 

2. Tapez le nom de votre fichier de projet. La plupart des fichiers generes 
(notamment les fichiers .EXE) sont par defaut derives du nom du projet 
(par exemple, <nom_prj>.CPP). 

3. Selectionnez le chemin d'acces ou sera enregistre le fichier de projet 
AppExpert (AppExpert cree le repertoire s'il n'existe pas). Ce repertoire 
devient le repertoire par defaut pour tous les fichiers source crees (vous 
pouvez changer le repertoire par defaut dans la boite de dialogue 
Application Generation Options avant de generer l'application). Vous 
pouvez, si vous le souhaitez, mettre chaque projet AppExpert dans son 
propre repertoire pour faciliter la modification des fichiers. Cliquez sur 
OK. La boite de dialogue Application Generation Options d' AppExpert 
apparait. 
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=■ Application 
° Basic Options 
° Advanced Options 
° Code Gen Control 
Admin Options 



4. Vous pouvez cliquer sur le bouton Generate dans le bas de la boite de 
dialogue pour generer l'application Windows par defaut ; vous pouvez 
aussi modifier les options affichees dans la boite de dialogue avant de 
generer l'application. La boite de dialogue presente une liste de sujets sur 
la gauche et a droite un bref descriptif du sujet selectionne (appuyez sur 
le bouton Help pour plus de renseignements sur les options associees au 
sujet concerne). Pour changer d'options d'application, 

■ Visualisez les options en cliquant sur un + pour afficher un des sous-su- 
jets (le + signifie que le sujet comporte des sous-sujets, un - que tous les 
sous-sujets sont affiches), puis selectionnez un sous-sujet. Vous pouvez 
par exemple cliquer sur le + qui suit Application (ou double-cliquer sur 
le mot "Application"), puis selectionner le sous-sujet Basic Options. Le 
tableau a droite affiche les options de base de toute application AppEx- 
pert. 

■ Choisissez les options que vous voulez inclure dans votre application. 
Vous pouvez par exemple modifier le repertoire Base ou sont 
sauvegardes les fichiers AppExpert (et que avez indique a l'etape 3). 

5. Cliquez sur le bouton Generate dans le bas de la boite de dialogue 
Options. 

6. Une boite de dialogue confirmant la generation du code apparait. 
Cliquez sur Yes pour generer le code (cliquez sur No pour revenir aux 
options de configuration). Pendant qu' AppExpert genere votre 
application, une boite de message apparait. 

AppExpert cree tous les fichiers destines a votre application et les place 
dans le repertoire Base (vous pouvez modifier les repertoires avant de 
generer l'application ; voir l'option Base Directory a la section 
"Application I Basic_Options" ci apres). 

Avec AppExpert, vous choisissez une fois pour toutes vos options 
d'application avant de generer le code. Lorsque le code et les ressources 
sont generes, vous pouvez les modifier et en ajouter d'autres, mais vous 
ne pouvez pas revenir a AppExpert pour changer d'options. Par 
exemple, si vous generez une application qui ne contient pas de ligne 
d'etat, vous ne pouvez pas utiliser AppExpert pour ajouter cette 
fonction : il vous faudra l'ajouter manuellement. 
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La fenetre du projet apparait avec la liste de quelques-uns des fichiers 
indispensables a votre application (les fichiers bitmap, les fichiers 
d'icones et de textes d'aide ne sont pas affiches). Vous pouvez utiliser 
ClassExpert pour modifier votre application, ou bien vous pouvez 
d'abord creer votre application (reportez-vous au chapitre 5 pour en 
savoir plus sur ClassExpert). Pour creer votre application, selectionnez 
Project I Make all (vous pouvez selectionner Build all, mais Make all est 
plus rapide). Le fichier executable (.EXE) est sauvegarde par defaut dans 
le repertoire Base. 



Applications Si vous ne modifiez aucune des options d'AppExpert au moment ou vous 

AppExpert par generez votre application, vous obtenez une application par defaut. Vous 

defaut pouvez explorer les options pour savoir quelles sont les options par defaut. 

Le fait de desactiver les options dont vous n'avez pas besoin accelere la 
generation et la creation de l'application. 

Options du menu Application 

Les options du menu Application determinent le style de votre application. 

Multiple Document Interface definit le style de votre application 
conformement au modele Multiple Document Interface (MDI). 

Single Document Interface definit le style de votre application 
conformement au modele Single Document Interface (SDI). 

Document/View determine si votre application gerera les objets de 
l'application selon le modele Document /View. "Document" correspond aux 
donnees et "view" a l'interface entre l'utilisateur et les donnees. Dans un 
modele Document/View, ces deux elements sont separes (reportez-vous au 
Guide du programmeur Object Windows pour plus d'informations sur 
Document/View). Vous pouvez utiliser cette option pour des applications 
SDI ou MDI. 

Speed Bar place une barre d'icones dans le haut de la fenetre principale de 
votre application. 

Status Line place une ligne d'etat dans le bas de la fenetre principale de 
votre application et genere un code pour afficher des messages d'aide sur la 
ligne d'etat quand des options de menu sont mises en surbrillance. 
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Drag/Drop traite les operations Windows standard de glisser-deplacer. 

Printing traite les activites d'impression et cree les menus File I Print Setup, 
Print Preview et Print. 



Application | Basic 
Options 



Application | 
Advanced Options 



Les options Basic definissent l'endroit ou est stocke le code genere et 
commandent les fichiers d'aide. 

Target Name prend le nom du projet que vous voulez creer comme base du 
nom par defaut des autres elements du projet (par exemple, les fichiers 
d'en-tete, de base de donnees des classes, des classes de l'application et les 
fichiers source). 

Base Directory definit le chemin d'acces du repertoire de base qui sera 
utilise pour enregistrer tous les repertoires du projet. Tous les chemins du 
projet sont lies a ce repertoire. Vous pouvez soit taper un nom de votre 
choix, soit en selectionner un dans la boite de dialogue Browse (cliquez sur 
le bouton Browse). Le nom du repertoire est transmis au gestionnaire de 
projet pour la nouvelle application AppExpert a creer. La valeur par defaut 
du repertoire de base est le repertoire du noeud pere du projet defini dans le 
gestionnaire de projet. Si vous donnez un nouveau nom, AppExpert cree le 
repertoire correspondant. 

Help File Support genere des fichiers sources d'aide (.RTF) et un fichier 
d'aide (.HPJ). Le fichier projet d'aide est ajoute au gestionnaire de projet ; il 
est automatiquement cree avec l'application resultante. Le fichier source 
d'aide comprend un texte de marque de reservation destine aux options des 
menus de l'application. 

Help File Name indique le nom des fichiers d'aide (.HLP et .HPJ) associes a 
votre application. 

Les options Advanced determinent le comportement de votre application au 
demarrage, ainsi que son aspect. 

Start Up definit l'etat initial de la fenetre principale de l'application. 

■ Normal (par defaut) : demarrage avec un format par defaut (defini par 
WS_NORMAL). 

■ Minimized : demarrage avec une icone dans l'ecran Windows. 

■ Maximized : remplit la totalite de l'ecran Windows au demarrage. 
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Control Style determine le type des commandes utilisees par l'application. 

■ Windows (par defaut) : commandes Windows standard. 

■ BWCC : style de commandes specifique a Borland. 

■ 3D : nouvelles commandes Windows en trois dimensions. 

Application | Code Les options de Code Gen Control concernent divers aspects du processus de 
Gen Control generation du code et determinent l'endroit ou est enregistre le code genere. 

Target Name affiche le nom du projet tel qu'il a ete defini dans 
BasicOptions I Target. 

Base Directory affiche le nom du repertoire de base du projet, tel que defini 
dans Basic Options I Base Directory. 

Source Directory indique le repertoire ou sont enregistres les fichiers 
source de l'application. Ce chemin d'acces utilise comme point de depart le 
repertoire indique comme Base Directory. Si un chemin absolu est indique, 
il est converti en chemin lie au Base Directory (vous ne pouvez specifier un 
autre lecteur). Vous pouvez taper directement un nom de repertoire de 
votre choix ou en selectionner un dans une liste (cliquez sur le bouton 
Browse). La valeur par defaut du chemin source est "A". 

Header Directory indique le repertoire ou sont enregistres les fichiers 
d'en-tetes de l'application. Ce chemin d'acces utilise comme point de depart 
le repertoire indique comme Base Directory. Si un chemin absolu est 
indique, il est converti en chemin lie au Base Directory (vous ne pouvez 
specifier un autre lecteur). Vous pouvez taper directement un nom de 
repertoire de votre choix ou en choisir un dans une liste (cliquez sur le 
bouton Browse). La valeur par defaut du chemin des en-tetes est "A". 

Main Source File designe le fichier source principal de l'application. 

Main Header File designe le fichier d'en-tetes principal de l'application. 

Application Class designe la classe qui est derivee par AppExpert de 
TApplication. Le nom de la classe par defaut est forme a partir du nom du 
projet. 

About Dialog Class designe la classe qui est derivee par AppExpert de 
TDialog. Le nom de la classe par defaut est forme a partir du nom du projet. 

Comments donne des renseignements partiels (terse) ou complets (verbose) 
sur le code genere. 
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Application|Admin Les options Admin permettent d'identifier les informations placees dans un 
Options bloc de commentaires place au debut de tous les fichiers generes pour le 

projet. Une partie de ces informations est affichee dans la boite de dialogue 

Help I About de l'application. 

Version Number correspond au numero de version du projet qui s'affiche 
dans la boite de dialogue Help I About (le numero par defaut est "1.0"). 
Cette information est stockee dans le fichier .RC de votre projet. 

Copyright definit les informations de copyright qui s'affichent dans la boite 
de dialogue Help I About de l'application. 

Description decrit l'application et affiche le texte correspondant dans la 
boite de dialogue Help I About de l'application. La valeur par defaut est le 
nom du projet. 

Author designe les programmeurs qui generent le code source ; il 
accompagne tout commentaire sur le code genere. 

Company designe la societe des programmeurs ; il accompagne tout 
commentaires sur le code genere. 

Options du menu Main Window 

Les options du menu Main Window commandent les fonctions de la fenetre 
principale de votre application, son aspect et son type. 

Window title designe le texte destine a la barre de titre de la fenetre 
principale de l'application. 

Background color definit la couleur du fond de la fenetre principale de 
l'application ; cliquez sur le bouton Background color pour selectionner une 
couleur. 



Main Window | Les options Basic commandent l'aspect general de la fenetre principale de 

Basic Options l'application. 

Window Styles commande l'aspect de la fenetre principale de l'application 
en indiquant le style de ses zones non-clientes. 

■ Caption cree un cadre a simple bordure et une barre de titre aux endroits 
ou une legende peut etre affichee. 

■ Border entoure la fenetre principale d'une simple bordure, sans barre de 
titre. 
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■ Max box ajoute un bouton d'agrandissement a droite de la barre de titre 
de la fenetre principale. Cette option n'est disponible que si l'option 
Caption est active. 

■ Min box ajoute un bouton de reduction a droite de la barre de titre de la 
fenetre principale (disponible uniquement si l'option Caption est active). 

■ Vertical scroll ajoute une barre de defilement vertical a droite de la 
fenetre principale. Cette option n'est disponible que si vous cochez 
Caption ou Border. 

■ Horizontal scroll ajoute une barre de defilement horizontal dans le bas de 
la fenetre principale. Cette option n'est disponible que si vous cochez 
Caption ou Border. 

■ System menu ajoute une case de menu systeme Windows a gauche de la 
barre de titre de la fenetre principale (disponible uniquement si l'option 
Caption est active). 

■ Visible rend la fenetre principale visible. Quand Visible est desactive, le 
style WSJVISIBLE est remplace par NOT WSJVISIBLE. 

■ Disabled desactive la fenetre principale par defaut (par exemple, si vous 
voulez afficher une image quand l'application est lancee). 

■ Thick frame entoure la fenetre principale d'une double bordure et rend la 
taille de la fenetre reglable. 

■ Clip siblings protege les noeuds des fenetres filles. Le rafraichissement 
d'ecran est limite a cette fenetre (voir WS_CLIPSIBLINGS dans l'aide en 
ligne de l'API). 

■ Clip children empeche les fenetres filles d'etre recouvertes par le 
rafraichissement de la fenetre principale de l'application (voir 
WS_CLIPCHILDREN dans l'aide en ligne de l'API). 

Main Window | SDI SDI Client definit la classe correspondant a la zone cliente de la fenetre 
Client principale de l'interface SDI. 

Client/view class indique le nom de la classe de fenetre ou d'affichage des 
zones clientes de la SDI. L'interpretation de cette valeur varie selon que 
vous avez ou non selectionne l'option Document/view au niveau de 
Application Model. Si Document/view est actif, Client/view class 
selectionne la classe d'affichage attribuee par defaut a Document/view. Si 
Document/view n'est pas actif, Client/view class selectionne la classe de la 
fenetre cliente. 
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... Tableau 4.1 Document/view actif Document/view inactif 

Client/view class 
avec Document/view 



TEditView (par defaut) 


TEditFile (par defaut) 


TListView 


TListBoxT 


WindowView 


TWindow 



Cette valeur est automatiquement mise en correspondance avec la valeur 
attribute a Document /view. Par exemple, si vous desactivez l'option 
Document/view, TListView bascule sur TListBox. Inversement, si vous 
activez l'option Document /view, TListBox bascule sur TListView. 

Document Class (TFileDocument par defaut) designe la classe du document 
par defaut (disponible si l'option Document/view est active). 

Description decrit la classe des fichiers associes a Document/view. La 
valeur par defaut est "All Files (*.*)". 

Filters (*.* par defaut) enumere, separes par des points-virgules ou des 
virgules, les masques de fichier avec caracteres generiques precisant le nom 
des fichiers que l'application doit reconnaitre. Cette valeur est transmise aux 
boites de dialogue des fichiers courants de Windows pour filtrer les fichiers 
affiches dans ces boites. 

Default extension precise l'extension par defaut du nom des fichiers. Cette 
valeur est transmise aux boites de dialogue des fichiers courants pour etre 
ajoutee au nom des fichiers quand aucune extension n'est donnee. 
L'extension par defaut est utilisee dans les boites de dialogue de File I Open 
et File I New. 
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Main Window|MDI MDI Client decrit la classe qui definit la fenetre cliente de la fenetre 
Client principale en mode Multiple Document Interface (disponible si MDI est 

selectionne au niveau d' Application Model). 

Client class precise le nom utilise par AppExpert pour la classe derivee de 
TMDIClient correspondant a la zone cliente de la fenetre MDI. 

Source file designe le fichier source dans lequel est enregistree 
l'implementation de la classe indiquee dans Client Class. 

Header file designe le fichier d'en-tetes dans lequel est enregistree la 
definition de la classe indiquee dans Client Class. 

Options du menu MDI Child/View 

Les options de MDI Child /View definissent la classe de la fenetre fille ou de 
Document/view (disponible si MDI et Document/view ont ete selectionnes 
dans Application Model). 

MDI child designe la classe derivee de TMDIChild correspondant au format 
des fenetres filles de MDI par defaut. 

Source file designe le fichier source dans lequel est enregistree 
l'implementation de la classe indiquee dans MDI child. 

Header file designe le fichier d'en-tetes dans lequel est enregistree la 
definition de la classe indiquee dans MDI child. 



MDI 

Child/View Basic 
Options 



Les options Basic definissent la fenetre fille MDI par defaut. 

MDI client/view class designe la classe d'affichage MDI par defaut. Le 
decodage de cette valeur differe selon que vous avez ou non selectionne 
l'option Document/View lors de la selection des parametres du menu 
Application : 



Tableau 4.2 
MDI client/view class 
avec Document/view 



Document/view actif 



Document/view inactif 



TEditView (par defaut) 

TListView 

TWindowView 



TEditFile (par defaut) 

TListBox 

TWindow 
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Cette valeur est automatiquement mise en correspondance avec les valeurs 
selectionnees pour Document/view. Par exemple, si vous desactivez 
l'option Document/view, TListViewbascule sur TListBox. Inversement, si 
vous activez l'option Document /view, TListBox bascule sur TListView. 

Document class designe la classe du document dans l'option 
Document/view par defaut (TFileDocument par defaut). 

Description decrit la classe de fichier associee a l'option Document/view. 
La valeur par defaut est "All Files (*.*)". 

Filters (*.* par defaut) enumere, separes par des points-virgules ou des 
virgules, les masques de fichier avec caracteres generiques precisant le noms 
de fichiers qui doivent etre reconnus par l'application. Cette valeur est 
transmise aux boites de dialogue des fichiers courants de Windows pour 
filtrer les fichiers affiches a l'interieur de ces boites. 

Default extension precise l'extension par defaut des noms de fichiers ; elle 
est transmise aux boites de dialogue des fichiers courants de Windows et 
sera ajoutee au nom des fichiers dont l'extension n'a pas ete precisee. 
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Utilisation de ClassExpert 



ClassExpert affiche les 

fonctions et 

evenements virtuels 

pour les classes 

existantes et verifie 

celles qui sont 

implementees dans 

votre application. 



ClassExpert permet de creer de nouvelles classes, de modifier et redefinir 
l'implementation des classes, et d'explorer le code source pour savoir 
quelles sont les classes de vos applications AppExpert. En adjoignant 
Resource Workshop a ClassExpert, vous pouvez associer des classes a des 
ressources (par exemple associer une classe TDialog a une ressource de 
dialogue). 



Lancement de ClassExpert 



#> 



Pour lancer ClassExpert, 

Ouvrez un fichier de projet AppExpert en selectionnant Project I Open 
project. 

Double-cliquez sur le noeud de l'application AppExpert (ClassExpert est 
le gestionnaire de visualisation par defaut des applications AppExpert), 
ou selectionnez View I ClassExpert, ou encore cliquez sur le bouton de 
la barre d'icones affichee a gauche. ClassExpert apparait avec la liste des 
classes et leur implementation dans votre application. 



1. 



2. 



ClassExpert : 
notions de base 



Cette section decrit les trois volets de ClassExpert et leur fonctions. Vous 
pouvez regler la taille des volets en tirant sur leur cadre. Quand vous 
modifiez la taille de ClassExpert, les volets gardent leurs proportions 
relatives. 
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Figure 5.1 
Fenetre ClassExpert 
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Volet Classes 



Le volet Classes enumere les classes gerees par ClassExpert pour 
l'application en cours. Les informations affichees dans les volets Events et 
Edit dependent de la classe selectionnee dans ce volet. Vous pouvez 
double-cliquer sur une classe pour acceder au code source du constructeur 
de la classe qui s'affichera dans le volet Edit. A l'aide du TurboMenu 
(cliquez avec le bouton droit dans le volet Classes), vous pouvez ajouter des 
classes, associer des classes de documents a des classes de visualisation, 
obtenir des renseignements sur une classe, acceder au code source ou au 
fichier d'en-tetes de la classe, modifier la classe et lancer Resource 
Workshop (en selectionnant Edit dialog ou Edit menu). 



Volet Events 



Le volet Events enumere les evenements et fonctions virtuelles de la classe 
de base de la classe selectionnee dans le volet Classes. Les informations 
affichees dans le volet Events dependent du type de classe de base choisi. 

Grace au TurboMenu d'Events (cliquez avec le bouton droit dans le volet 
Events), vous pouvez ajouter ou supprimer des gestionnaires de messages et 
des variables d'instance. 



Volet Edit 



Le volet Edit est un editeur qui affiche le code source des articles 
selectionnes dans le volet Classes et dans le volet Events. Le volet Edit a la 
meme fonction qu'une fenetre d'editeur EDI : si vous modifiez ou mettez a 
jour les options de l'editeur EDI, celles-ci sont immediatement disponibles 
dans le volet Edit de ClassExpert . 
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Le volet Edit utilise le menu principal de l'EDI et possede un TurboMenu 
accessible en cliquant avec le bouton droit dans le volet Edit. Le volet Edit 
fonctionne exactement comme une fenetre d'editeur EDI, a ceci pres que 
vous ne pouvez pas scinder les volets ou ouvrir d'autres fichiers a l'interieur 
du volet Edit. 



Ajouter une classe 



ClassExpert vous permet d'ajouter des classes du type ObjectWindows et 
peut prendre en charge un niveau d 'heritage (vous pouvez ajouter 
manuellement d'autres derivations). 

Pour ajouter une classe, 

1. Cliquez avec le bouton droit dans le volet Classes. Le TurboMenu 
apparait. 

2. Selectionnez Create new class ou cliquez sur le bouton de la barre 
d'icones affiche a gauche. La boite de dialogue Add New Class apparait. 

3. Selectionnez la classe de base ObjectWindows a partir de laquelle vous 
voulez deriver la classe. Appuyez sur Tab. 

4. Tapez le nom que vous voulez donner a la nouvelle classe. Appuyez sur 
Tab. 

5. Tapez le nom du fichier source dans lequel vous voulez voir figurer le 
code source. Le fichier est sauvegarde dans le chemin source du projet. 
Appuyez sur Tab. 

6. Tapez le nom du fichier d'en-tetes qui definit la classe. Par defaut ce 
fichier prend le nom du fichier source, mais avec l'extension .H. 
Appuyez sur Tab. 

7. Les selections qui suivent dependent de la classe de base : 

■ Si la classe de base est TDialog, vous devez indiquer ou selectionner un 
ID de modele de dialogue. La boite Dialog ID list affiche les ID de 
toutes les ressources de dialogue de votre application AppExpert . Si 
vous indiquez un ID qui n'existe pas, AppExpert cree une boite de 
dialogue vide contenant 1TD indique (par souci de coherence vous 
pouvez utiliser le prefixe IDD_), puis Resource Workshop se charge 
pour vous permettre de definir la boite de dialogue. 

■ Si la classe de base est TFrameWindow ou une classe derivee de 
TFrameWindow, vous pouvez choisir une classe existante et affichee 
dans la boite Client class list pour representer la zone cliente de la 
nouvelle fenetre principale de l'application. 
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Creer des types de 
documents 



Voir la documentation 

d'ObjectWindows pour 

toute information 

complementaire sur 

ces classes. 



■ Si la classe de base est TWindow ou une classe derivee de TWindow, 
cliquez sur le bouton Set Window Properties. Une boite de dialogue 
apparait dans laquelle vous pouvez definir les proprietes de la fenetre, 
notamment sa couleur, son cadre et sa legende. Reportez-vous a l'aide 
en ligne (cliquez sur le bouton Help) pour de plus amples 
renseignements sur chaque propriete. 

8. Cliquez sur OK pour ajouter la nouvelle classe. 

Quand vous creez une application AppExpert prenant en charge 
document/view, vous pouvez utiliser ClassExpert pour creer des classes de 
visualisation et des types de documents. 

Pour creer un type de document, 

1. Creez une classe de visualisation, a moins que vous ne vouliez utiliser 
l'une des trois classes de visualisation predefinies (TEditView, TListView, 
ou TWindowView). 

2. Lancez ClassExpert a partir de votre projet. Cliquez avec le bouton droit 
dans le volet Classes, puis selectionnez Create doc types dans le 
TurboMenu. 

3. Selectionnez une classe de visualisation (si vous avez cree votre propre 
classe, elle figure dans la liste). Les classes de visualisation par defaut 
sont les suivantes : 

■ TEditView fournit un visualisateur de textes formates pour la classe 
d'edition de texte d'ObjectWindows. 

■ TListView permet la visualisation de boites d'enumeration. 

■ TWindowView permet la visualisation dans des fenetres. 

4. Tapez un descriptif des types de fichiers que votre type de document 
acceptera. Ce texte apparait dans la boite de dialogue File I Open. 

5. Tapez le nom des filtres que vous voulez utiliser en les separant par des 
virgules ; ces filtres sont affiches dans la boite de dialogue File I Open et 
permettent de filtrer tous les fichiers qui peuvent etre ouverts par un 
utilisateur et utilises dans votre application. Par exemple, si vous creez 
un type de document pour des images en mode points, vous pourriez 
avoir un filtre * . BMP. 

6. Tapez une extension par defaut pour votre application ; elle sera utile 
quand vous sauvegarderez des fichiers. 
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7. Cliquez sur le bouton Style pour definir les styles de document /view. 
Les choix possibles sont les suivants (pour plus de renseignements, 
reportez-vous a la documentation d'ObjectWindows) : 

■ dtAutoDelete supprime l'objet document quand le dernier ecran est 
ferme. 

■ dtNoAutoView ne cree pas automatiquement un type d'ecran par defaut. 

■ dtSingleView ne donne qu'un ecran pour chaque document. 

■ dtAutoOpen ouvre un document quand il est cree. 

■ dtUpdateDir met a jour le repertoire avec le repertoire des boites de 
dialogue. 

■ dtHidden n'affiche pas le modele dans la liste des selections utilisateur. 

■ dtSelected indique le dernier modele selectionne. 

■ dtReadOnly coche la case a cocher "lecture seule" quand la boite de 
dialogue est creee. 

■ dtOverWritePrompt demande a l'utilisateur s'il est d'accord pour 
ecraser un fichier existant quand il utilise la boite de dialogue Save As. 

■ dtHideReadOnly cache la case "lecture seule". 

■ dtPathMustExist n'autorise l'utilisateur a taper que des chemins 
existants. 

■ dtFileMustExist n'autorise l'utilisateur a taper que des noms de fichiers 
existants. 

■ dtCreatePrompt demande confirmation a l'utilisateur avant de creer un 
nouveau document. 

■ dtNoReadOnly restitue le fichier indique sans protection contre 
l'ecriture. 

8. Cliquez sur Add pour inclure le type de document dans votre 
application (cette operation met a jour une structure des donnees du 
fichier source principal qui decrit tous les types de documents 
disponibles). Document /view apparait dans la liste des types existants. 

9. Reprenez les etapes 1 a 8 pour chaque type de document que vous 
voulez creer. Quand vous avez fini, cliquez sur Close pour revenir a 
ClassExpert. 
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Ajout et 

suppression de 
gestionnaires 
d'evenements 



v^ 



V 



Pour ajouter un gestionnaire destine a un evenement donne, 

1. Selectionnez la classe du gestionnaire de messages. Les evenements 
s'affichent dans le volet Events. 

2. Selectionnez l'evenement a traiter (il se peut que vous soyez oblige de 
developper la liste des evenements), puis cliquez avec le bouton droit sur 
l'evenement pour afficher le TurboMenu. 

3. Choisissez Add handler dans le TurboMenu. Si vous choisissez d'ajouter 
un gestionnaire pour un message Windows, ClassExpert ajoute une 
entree a la table de recherche dont le nom est defini par defaut, puis la 
fonction associee au gestionnaire apparait dans la fenetre d'edition. 
D'autres gestionnaires, par exemple des commandes, vous demandent 
d'indiquer le nom de la fonction avant d'ajouter l'entree dans la table de 
recherche. 

4. ClassExpert affiche une coche a cote de l'evenement dans le volet Events 
pour vous montrer que l'evenement est pris en charge. Une marque d'un 
gris plus clair indique que certains evenements a l'interieur de la 
categorie concernee sont pris en charge (developpez la liste pour 
visualiser ces evenements). 

Pour supprimer le gestionnaire d'un evenement, 

1. Selectionnez la classe du gestionnaire de messages. Les evenements 
s'affichent dans le volet Events. 

2. Selectionnez l'evenement coche avec le gestionnaire que vous voulez 
supprimer (il vous faudra peut-etre developper la liste des evenements), 
puis cliquez avec le bouton droit sur l'evenement pour afficher le 
TurboMenu. 

3. Selectionnez Delete handler. ClassExpert supprime uniquement l'entree 
de la table de recherche, pas le code du fichier source. Le code du 
gestionnaire apparait dans le volet Edit, ce qui vous permet de le 
supprimer. Si vous supprimez la fonction, supprimez sa definition dans 
le fichier des en-tetes (vous pouvez selectionner Edit header dans le 
TurboMenu du volet Classes pour visualiser le fichier). 
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Ajout et 

suppression de 
variables d'instance 



Les variables d'instance facilitent la gestion de nombreux controles. Quand 
vous creez des variables d'instance, ClassExpert ajoute un tampon de 
transfert dans votre code. Ce tampon collecte les informations au moment 
de l'execution, informations que vous pouvez utiliser au lieu de creer un 
code pour verifier si toutes les cases sont cochees. Par exemple, si vous avez 
une boite de dialogue avec six cases a cocher et si vous voulez que votre 
application fasse quelque chose en fonction des cases cochees, vous pouvez 
utiliser des variables d'instance pour chaque controle puis les donnees du 
tampon de transfert de votre code. Reportez-vous au Guide du programmeur 
ObjectWindows pour tout renseignement complementaire sur les tampons de 
transfert. 

Pour ajouter (associer) une variable d'instance a un controle, 

1. Selectionnez le controle dans le volet Events (vous serez peut-etre oblige 
de developper la liste des evenements pour visualiser les controles). 

2. Cliquez avec le bouton droit sur le controle et selectionnez Add Instance 
variable. 

3. Dans la boite de dialogue Add Instance variable tapez le nom de la 
variable. Cliquez sur OK. ClassExpert ajoute ce qui suit au code de votre 
application : 

■ Dans le fichier d'en-tetes, il ajoute une declaration de structure avec 
une entree pour la variable d'instance. 

■ Dans le constructeur de classes du fichier source .CPP, la variable est 
affectee (pour associer la classe ObjectWindows a l'objet ressource). 

■ Dans le fichier .CCP, un exemple statique de la structure de transfert 
est declare. 

4. L' etiquette de controle du volet Events indique la classe et le nom de la 
variable d'instance que vous venez de creer. 

Pour supprimer une variable d'instance, 

1. Selectionnez le controle accompagne de la variable d'instance que vous 
voulez supprimer. 

2. Cliquez avec le bouton droit sur le controle et selectionnez Delete 
Instance variable. 
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3. ClassExpert supprime de votre code ce qui suit : 

■ L'entree de la structure 

■ La variable de pointeur dans la declaration de classe 

■ L'affectation de la variable de classe associee au controle ressource 
dans le constructeur 

Si vous supprimez toutes les variables d'exemple de votre code, il 
restera une structure vide et la convention d'appel du tampon de 
transfert definie. Ces informations n'ayant aucune incidence sur le 
reste du code, vous n'avez pas besoin de les supprimer manuellement. 



Acces au code Pour visualiser le code source d'une classe, selectionnez cette classe dans le 

source des classes volet Classes (cliquez une fois sur son nom). Le code apparait dans le volet 
Edit. Si vous deplacez le curseur dans le volet Edit, ClassExpert memorise sa 
position et y revient des que vous selectionnez a nouveau cette classe. 

Pour acceder au code du constructeur de la classe, double-cliquez sur le 
nom de la classe dans le volet Classes. Pour acceder a un evenement gere, 
double-cliquez sur l'evenement concerne dans le volet Events. Vous pouvez 
aussi visualiser le fichier source ou son fichier d'en-tetes dans un editeur 
EDI: 

1. Selectionnez la classe dans le volet Classes. 

2. Cliquez avec le bouton droit sur la classe. Un TurboMenu apparait. 

3. Choisissez Edit source pour visualiser le fichier source du constructeur 
de classes (fichier .CPP), ou choisissez Edit header pour visualiser le 
fichier d'en-tetes dans lequel la classe est definie. 

Utilisation de Resource Workshop avec ClassExpert 



Resource Workshop est le gestionnaire de visualisation des scripts 
ressources (fichiers .RC) de ClassExpert . Quand vous lancez Resource 
Workshop a partir de ClassExpert (en cliquant avec le bouton droit sur une 
classe et en selectionnant Edit dialog ou Edit menu), Resource Workshop 
charge automatiquement le script RC de cette application. 
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Execution de 
Resource 
Workshop a partir 
de I'EDI 



Quand vous utilisez Resource Workshop avec un code genere par 
AppExpert, faites-le tourner a partir de ClassExpert car Resource Workshop 
et ClassExpert se mettent mutuellement a jour chaque fois que vous 
apportez des modifications au projet. Des qu'il est lance, Resource 
Workshop verifie le code ressource pour detecter toute modification 
eventuelle, puis envoie immediatement des mises a jour a ClassExpert. Par 
exemple, si vous ajoutez un bouton dans une boite de dialogue, Resource 
Workshop en informe ClassExpert, qui ajoute le controle correspondant 
dans le volet Events. Pour visualiser ce controle dans ClassExpert, 
selectionnez-le dans Resource Workshop, cliquez avec le bouton droit puis 
selectionnez ClassExpert dans le TurboMenu. Resource Workshop vous 
renvoie ClassExpert avec le controle en surbrillance dans le volet Events. 

Quand vous lancez Resource Workshop comme gestionnaire de 
visualisation d'une application AppExpert (par 1' inter mediaire soit du 
gestionnaire de projet de l'EDI, soit de ClassExpert), il n'a pas le meme 
comportement que quand il tourne separement : 

■ Quand vous effectuez dans Resource Workshop des modifications qui ont 
une incidence sur la structure des classes ou leurs fonctions (par exemple 
les menus d'edition ou les boites de dialogue), ces modifications sont 
instantanement mises a jour dans la fenetre ClassExpert. 

■ Vous ne pouvez pas ouvrir un autre script (ni File I Open ni File I New). 

■ Si vous fermez l'EDI, Resource Workshop est lui aussi ferme et toutes les 
modifications que vous avez apportees sont automatiquement 
sauvegardees. 

■ Si vous fermez le fichier de projet AppExpert a partir duquel vous avez 
lance Resource Workshop, vous fermez du meme coup Resource 
Workshop. 

■ Si vous creez un projet alors que Resource Workshop est ouvert, ce 
dernier cree un fichier .RES base sur les ressources chargees. Par exemple, 
si vous modifiez une boite de dialogue et ne la sauvegardez pas, le fichier 
.RES conservera les modifications non sauvegardees. 

■ Vous pouvez acceder a l'EDI a partir de Resource Workshop grace au 
TurboMenu (cliquez avec le bouton droit), en selectionnant ClassExpert. 
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Utilisation de Rescan 



Rescan est un outil special qui inspecte tous les codes source dont la liste 
figure dans votre projet AppExpert (fichier .IDE), pour mettre a jour et 
reconstituer la base de donnees du projet (fichier .APX) en fonction de ce 
qu'il trouve dans le code source. Rescan recherche les marques speciales 
dans le code source pour reconstituer le fichier de base de donnees 
d' AppExpert, puis lance Resource Workshop pour reconstituer les 
informations relatives aux ressources du projet. Si la relecture se deroule 
normalement, le fichier de base de donnees initial du projet est renomme 
*.~AP et un nouveau fichier de base de donnees cree ; sinon, la base de 
donnees d'origine reste *.APX. 

Vous pouvez utiliser Rescan pour : 

■ Supprimer une classe 

■ Deplacer une classe d'un fichier source a un autre 

■ Renommer une classe, un gestionnaire, une variable d'instance ou un ID 
de dialogue 

■ Importer une classe d'un autre projet AppExpert 

■ Reconstituer un fichier de base de donnees de projet (*.APX) perdu ou 
endommage 



Supprimer une Pour supprimer une classe, 

classe 

1. Retirez le fichier source de la classe du projet EDI en selectionnant le 

noeud source, en cliquant avec le bouton droit et en selectionnant Delete 
node. Si la classe partage un fichier source avec d'autres classes, 
supprimez dans le fichier source le code de la classe concernee, ainsi que 
tout reference a cette classe dans les autres fichiers source. 

2. Selectionnez l'application AppExpert dans le projet, cliquez avec le 
bouton droit, puis selectionnez Special I Rescan. Rescan explore les 
fichiers source mentionnes comme dependances de l'application 
AppExpert . Resource Workshop explore et met a jour les fichiers de 
ressources. Quand Rescan a termine, vous revenez au fichier de projet - 
mis a jour - a partir duquel vous pourrez soit creer votre application, soit 
utiliser ClassExpert. Vous pouvez ajouter au projet la classe supprimee 
en ajoutant le fichier source de la classe et en le liant a l'application 
AppExpert, puis en executant une nouvelle relecture. 



1 1 6 Borland C++ Guide de I'utilisateur 



Deplacer une 
classe 



Pour deplacer une classe d'un fichier source a un autre, 

1. Deplacez (par couper-coller) le code source de la classe pour l'integrer 
dans le nouveau fichier. Si le nouveau fichier ne figure pas dans le projet 
en tant que noeud de l'application AppExpert, ajoutez-le (reportez-vous 
au chapitre 2). Si la classe deplacee etait son prop re fichier source, vous 
pouvez supprimer du projet ce fichier source, desormais vide. 

2. Selectionnez l'application AppExpert dans le projet, cliquez avec le 
bouton droit pour afficher le TurboMenu, puis selectionnez Special I 
Rescan. Lorsque Rescan a termine, la fenetre de projet EDI s'affiche a 
nouveau. 



Renommer un 
element 
d' AppExpert 



Pour renommer une classe, une fonction de gestion d'evenement, une 
variable d'instance ou un ID de dialogue, 

1. Utilisez l'editeur EDI pour rechercher et remplacer partout le nom 
d'origine par le nouveau nom. Veillez a verifier tous les fichiers source 
lies au projet (fichiers .CPP et .H). 

2. Dans la fenetre du projet, selectionnez l'application AppExpert , cliquez 
avec le bouton droit, puis selectionnez Special I Rescan. Quand Rescan a 
termine, la fenetre du projet EDI s'affiche a nouveau. 



Importer une classe 



Pour importer une classe d'un projet AppExpert dans un autre, 

1. Deplacez ou copiez le fichier source et le fichier d'en-tetes qui definissent 
la classe dans le repertoire source et d'en-tetes de l'autre projet. Tous les 
fichiers source d'un projet doivent se trouver dans le repertoire source 
(fichiers .CPP) ou dans le repertoire d'en-tetes (fichiers .H) de ce projet. 
Ces repertoires ont ete crees quand vous avez genere pour la premiere 
fois le projet AppExpert . 

2. Ajoutez le fichier source de classe sous forme de noeud lie a l'application 
AppExpert dans le projet EDI (a l'aide de l'option Add node du 
TurboMenu). 

3. Dans la fenetre du projet, selectionnez l'application AppExpert , cliquez 
dessus avec le bouton droit, puis selectionnez Special I Rescan. 
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Reconstitution du Pour reconstituer un fichier de base de donnees perdu ou endommage (le 
fichier de base de fichier .APX), 
donnees .APX 

1. Ouvrez le fichier de projet qui contient l'application AppExpert et les 

noeuds dependants (dans le fichier .IDE). 

2. Selectionnez l'application AppExpert, cliquez avec le bouton droit, puis 
selectionnez Special I Rescan dans le TurboMenu. Rescan cree 
automatiquement un nouveau fichier de base de donnees en utilisant les 
marques du code source de l'application AppExpert . 
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Debogage dans I'EDI 



Meme si vous prenez toutes vos precautions lorsque vous entrez votre code, 
votre programme risque de contenir des erreurs (des bugs). Le debogage est 
l'operation qui consiste a localiser et a corriger ces bugs. Ce chapitre 
explique comment proceder. 



Types de bugs 



II existe trois types de bugs : les erreurs a la compilation, les erreurs a 
l'execution et les erreurs de logique. 



Erreurs a la Ces erreurs, aussi appelees erreurs de syntaxe, se produisent lorsque votre 

compilation code enfreint la syntaxe C ou C++, auquel cas l'EDI ne peut compiler votre 

programme et ouvre une fenetre de message contenant toutes les erreurs et 

les avertissements. 

Vous devrez corriger les erreurs l'une apres l'autre. Pour ce faire, 
double-cliquez dessus ; le curseur se place automatiquement sur la ligne 
erronee. Repetez cette operation autant de fois que necessaire. 

Les avertissements affiches dans la fenetre de message n'empechent pas la 
compilation de votre programme, mais ils attirent votre attention sur du 
code qui peut poser probleme (code non portable, non optimise ou non 
conforme au standard ANSI). Vous pouvez choisir le type avertissements 
que vous desirez voir : 

1. Choisissez Options I Project et double-cliquez sur Messages. 

L'EDI affiche les diverses categories de messages et, a droite, les options 
correspondantes. 



Chapitre 6, Debogage dans l'EDI 1 1 9 



2. Selectionnez une option determinant quels avertissements sont affiches 
par l'EDI. 

■ Cochez All pour afficher tous les messages. 

■ Cochez Selectionnezed pour n' afficher que les avertissements 
selectionnes (voir etape 4) 

■ Cochez None pour n'afficher aucun message. 

3. Limitez le nombre de messages d'erreurs et avertissements affiches dans 
la fenetre Message. Dans les cases Stop After, indiquez le nombre de 
messages maximum d'avertissements et d'erreurs (de a 255) affiches 
lors de la compilation. 

Si vous entrez dans les deux cases, aucune limite n'est imposee. 

4. Dans la zone Topics, choisissez une categorie de messages. 

5. A droite, selectionnez les messages a afficher dans l'EDI. 

Par exemple, si vous desirez que le compilateur vous avertisse des 
conversions de pointeurs risquant de n'etre pas conforme au standard 
ANSI, choisissez ANSI Violations et cochez Suspicious Pointer 
Conversion. 

Les erreurs a la compilation les plus frequentes sont les fautes de frappe, les 
oublis de points-virgules, les references a des variables non declarees, les 
passages d'arguments errones aux fonctions et les mauvaises assignations 
de valeurs aux variables. 

Relancez la compilation apres avoir corrige vos erreurs. Si tout se passe 
bien, vous pouvez rechercher les eventuelles erreurs a l'execution et de 
logique. 



Erreurs a 
l'execution 



Si votre programme se compile bien mais ne s'execute pas, il s'agit d'une 
erreur a l'execution : les instructions sont correctes, mais elles ne peuvent 
pas s'executer (demande d'ouverture d'un fichier introuvable ou division 
par zero, par exemple). Le systeme d'exploitation detecte ces erreurs et 
stoppe l'execution du programme. 



Erreurs de logique 



Les erreurs de logique sont des erreurs de conception ou d'implementation. 
Vos instructions sont correctes et declenchent bien une action, mais pas celle 
que vous aviez prevue. Ces erreurs sont les plus dedicates a corriger, car 
l'EDI ne sait pas les detecter automatiquement. Heureusement, l'EDI integre 
des outils de debogage qui vous aideront dans cette tache. 
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Les erreurs de logique se produisent lorsque des variables ont une valeur 
incorrecte ou inattendue, lorsque des images n'ont pas l'aspect voulu ou 
lorsque du code ne s'execute pas quand il le devrait. Les pages qui suivent 
expliquent comment corriger ces erreurs. 



Creation d'informations de debogage 



Vous devez compiler et editer les liens de votre programme pour que des 
informations de debogage soient generees dans vos EXE et vos OBJ. 

■ Pour ajouter des informations de debogage a vos OBJ, choisissez Options 
I Project et selectionnez Compiler I Debugging I Debug Information in 

OBJs dans la boite de dialogue qui s'ouvre alors. Cette option est activee 
par defaut. 

■ Pour ajouter des informations de debogage a vos EXE, choisissez Options 
I Project et selectionnez Linker I General I Include Debug Information 
dans la boite de dialogue qui s'ouvre alors. Cette option est activee par defaut. 

Des que vous compilez un programme, le compilateur genere une table des 
identificateurs utilises et la stocke dans le richer executable. Cette liste, 
appelee la table des symboles, est utilisee par le debogueur pour tracer les 
variables, constantes, types, fonctions et instructions de votre programme. 



Indication des arguments du programme 



Si le programme a deboguer requiert le passage d'arguments, vous devez 
les specifier : 

1. Choisissez Options I Environment et selectionnez un sujet pour le 
debogueur. 

2. Dans la case Run Arguments, entrez les arguments que vous desirez 
passer au programme. 



Controle de I'execution du programme 



Le controle de I'execution du programme est la partie la plus importante du 
debogage. Etant donne qu'il est possible de controler I'execution de chaque 
instruction, il est aise de savoir quelle partie du programme pose un 
probleme. 
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Le mode pas a pas ("stepping") et le trace ("tracing") permettent l'execution 
d'un programme instruction par instruction. Vous pouvez alors etudier 
l'etat du programme et des donnees, verifier la sortie generee par le 
programme et la valeur des variables, ou modifier ou evaluer des 
expressions avant de passer a l'instruction suivante. 



Verification de la 
sortie generee par 
le programme 



Lorsque vous executez votre programme en mode pas a pas, vous pouvez 
etudier la sortie de votre application dans sa propre fenetre. Configurez 
votre ecran pour qu'il affiche a la fois votre code source et la fenetre de votre 
application. Si la fenetre du bureau de l'EDI et celle de votre application se 
chevauchent lorsque vous deboguez, vous obtiendrez une image instable. 



Mode pas a pas 



C) 



Toute execution dans le debogueur, y compris le mode pas a pas, le trace et 
le respect des points d'arret, est liee aux lignes du code source. Meme si une 
instruction tient sur plusieurs lignes a l'ecran, elle est vue comme une seule 
ligne de code. 

Vous pouvez controler la quantite de debogage au niveau de l'unite de ligne 
de code. Si vous placez plusieurs instructions sur une seule ligne, vous ne 
pourrez pas deboguer une seule de ces instructions. Par contre, vous pouvez 
repartir une instruction sur plusieurs lignes, et voir cette instruction 
s'executer en une seule fois. 

Lorsque vous demandez au debogueur de passer en pas a pas ou en trace, le 
point d'execution (la ligne en surbrillance dans votre code) passe a la ligne 
suivante. Le point d'execution marque toujours l'instruction qui sera 
executee apres la presente. 

Le mode pas a pas est la facon la plus simple de vous deplacer a votre 
rythme dans le code. Pour ce faire, choisissez Debug I Step Over (ou F8, ou 
le bouton Pas a pas dans la barre d'icones). Le code en surbrillance 
s'execute, y compris toute fonction qu'il doit appeler avant de vous rendre 
la main. Le point d'execution passe ensuite sur la ligne suivante. 
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L'exemple ci-dessous vous aidera a comprendre comment fonctionne le 
mode pas a pas. Void les premieres lignes d'un programme charge dans la 
fenetre d'edition : 



BOOL InitApplication ( HINSTANCE hlnstance ) 
{ 

WNDCLASS wc; 

wc. style = CS_HREDRAW I CS_VREDRAW; 

wc.lpfnWndProc = (long (FAR PASCAL*) ()) MainWnProc; 

wc . cbClsExtra = 0; 

wc . cbWndExtra = 0; 

return ( RegisterClass ( &wc) ) ; 



int PASCAL WinMain ( HINSTANCE hlstance, HINSTANCE 

hPrevInstance, 

LPSTR lpCmdLine, int nCmdShow) 

{ 

MSG msg; 

if ( ! hPrevInstance ) 

if ( ! InitApplciation ( hlnstance ) ) 
return ( FALSE ) ; 

if ( ! Init Instance ( hlnstance, nCmdShow ) ) 
return ( FALSE ) ; 



Dans cet exemple, InitApplication est une fonction definie dans un module 
que vous avez compile avec les informations de debogage. Si vous 
deboguiez reellement ce programme, a chaque fois que vous choisiriez 
Debug I Step Over (ou appuieriez sur F8), le debogueur executerait la ligne 
en surbrillance, puis le point d'execution passerait sur la ligne suivante. Si 
vous appuyiez sur F8 lorsque le point d'execution est sur l'instruction 
suivante, 

if ( ! InitApplication ( hlnstance ) ) 
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le debogueur executerait la fonction InitApplication et retournerait une 
valeur booleenne, mais vous ne verriez pas le point d'execution passer sur 
l'instruction InitApplication elle-meme : le debogueur passerait au-dessus 
de la fonction. La main vous serait rendue apres l'execution de cette fonction. 



Trace du code en 
mode approfondi 



ci 



Dans ce mode, a la difference du mode pas a pas, lorsque vous arrivez sur 
une ligne qui appelle une fonction, le point d'execution se place dans le code 
de la fonction. Dans l'exemple ci-dessus, si vous choisissez Debug I Trace 
Into (ou appuyez sur F7 ou cliquez sur le bouton Trace en mode approfondi 
de la barre d'outils) pour executer chaque instruction, vous voyez le point 
d'execution se place sur le code implementant la fonction InitApplication 
lorsque le debogueur atteint instructions evaluant la valeur de retour de 
InitApplication. Lorsque vous deboguez, vous pouvez choisir librement l'un 
ou l'autre de ces deux modes d'analyse de votre code source. 



Mode pas a pas et 
mode approfondi 
appliques aux 
fonctions membres 
d'une classe 



Meme si vous utilisez les classes dans votre programme, vous pouvez 
utiliser le debogueur integre dans ces deux modes. II gere les fonctions 
membres de la meme facon qu'il gere les fonctions dans les programmes 
non orientes objets. 



Mode pas a pas et 
mode approfondi 
appliques au code 
externe 



Si vous liez du code externe a votre programme, vous pouvez le deboguer 
dans ces deux modes si le code du fichier OBJ lie contient des informations 
de debogage. 

II est possible de deboguer du code externe ecrit en tout langage, y compris 
C, C++, Pascal et assembleur. Si le code est conforme aux normes de linkage 
externe et contient des informations symboliques de debogage completes 
aux normes Borland, le debogueur integre peut le traiter dans les deux 
modes. 



Contourner une Parfois, pour atteindre directement le source qui vous semble errone, vous 

partie du code souhaiterez contourner une partie de votre code. Le debogueur integre vous 

permet ceci, et vous redonne la main a l'emplacement de votre choix. 
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Recherche dune Vous pouvez atteindre directement une partie precise de votre code. 

zone precise Procedez comme suit : 

1. Placez le curseur sur la ligne ou vous desirez reprendre le debogage. 

2. Choisissez Run to Cursor dans le TurboMenu, ou appuyez sur F4. 

Vous pouvez faire ceci au debut du debogage au en cours de session. 



Recherche d'une 
fonction 



Retour au point 
d'execution 



Remonter dans le 
code 



La commande Locate Function du menu Search vous permet d'atteindre 
rapidement une fonction precise. Pour l'utiliser, vous devez etre en mode 
debogage. 

Lorsque vous deboguez, vous pouvez vous deplacer librement dans les 
fichiers ouverts, ouvrir ou termer des fichiers, puis revenir rapidement au 
point d'execution. 

Pour ce faire, choisissez Debug I Find Point d'execution. 

Si la fenetre contenant le point d'execution a ete fermee, le fichier est 
automatiquement reouvert. 

II est parfois utile, lorsque vous deboguez, de savoir comment vous etes 
parvenu a la section de votre code source dans laquelle vous vous trouvez. 
La fenetre Call Stack vous indique la suite de fonctions qui vous a conduit la 
ou vous etes. Choisissez View I Call Stack pour afficher cette fenetre. 

La fenetre Call Stack est tres utile si vous arrivez par erreur dans une zone 
de code que vous desirez contourner. Vous pourrez ainsi revenir en arriere 
puis reprendre le trace a l'endroit de votre choix : 

1. Dans la fenetre Call Stack, double-cliquez l'appel ayant lance la fonction 
sur laquelle vous etes arrive par erreur ; il s'agit du second appel en 
partant du sommet de la fenetre. 

La fenetre d'edition devient la fenetre active ; le curseur est place a 
l'endroit ou l'appel a eu lieu. 

2. Dans le fenetre d'edition, placez le curseur au-dessous de l'appel. 

3. Choisissez Run to Cursor dans le TurboMenu de la fenetre d'edition. 

La fenetre Call Stack est aussi tres utile pour visualiser les arguments passes 
a vos fonctions. 
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Pour voir ou editer le code source contenant un appel precis, selectionnez 
l'appel en question dans la fenetre Call Stack et cliquez (avec le bouton droit 
de la souris) pour afficher le TurboMenu avec ses commandes de 
visualisation et d'edition. 



Arret du Pour arreter votre programme, vous pouvez utiliser une autre methode que 

programme les deux que nous venons d'etudier : il suffit de choisir Debug I Pause 

Program. Vous pouvez alors examiner la valeur des variables et visualiser 
les donnees de votre programme. Pour le relancer, choisissez Debug I Run. 

Si votre programme refuse de vous rendre la main (s'il est pris dans une 
boucle sans fin, par exemple), appuyez sur Ctrl+Alt+Syst pour l'arreter. 



Recommencer Terminate Program (commandeSi, en cours de debogage, vous decidez de 

depuis le debut recommencer depuis le debut de votre programme, choisissez Debug I 

Terminate Program ou appuyez sur Ctrl+F2. 

Visualisation des valeurs 

Le trace du code et le mode pas a pas sont parfaits pour trouver les 
problemes dans le deroulement d'un programme, mais il est aussi 
important de savoir quelle valeur prennent vos variables. Par exemple si 
vous executez pas a pas une boucle for, il est utile de verifier revolution de 
la variable d'index. L'EDI offre plusieurs outils qui vous le permettent : 

■ La fenetre Watch affiche la valeur d'une variable ou d'une expression. 

■ La boite de dialogue Evaluate Expression vous permet d'evaluer toute 
expression en rapport avec votre programme, et de modifier la valeur 
d'une variable en cours de debogage. 

■ La fenetre Data Inspector vous permet d'evaluer et de modifier la valeur 
d'une donnee. 



Qu'est-ce qu'une La visualisation, 1'evaluation et l'inspection operent au niveau des 

expression ? expressions. Une expression consiste en une constante, une variable ou une 

structure de donnees associees a des operateurs. Pratiquement tous les 
elements utilisables dans la partie de droite d'une instruction d'assignation 
peuvent servir expression de debogage. 
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Visualisation des Si vous desirez suivre la valeur d'une expression ou d'une variable tout en 

expressions executant votre code pas a pas, utilisez un suivi ("watch"). Un suivi est une 

expression, entree dans la fenetre Watch, qui indique la valeur courante de 
expression en refletant toute modification que lui apporte votre programme. 

Si le point d'execution depasse la portee d'une expression de suivi, 
expression est indefinie. Lorsque le point d'execution retourne dans la 
portee, la fenetre Watch reaffiche la valeur de expression. 

Pour ouvrir la fenetre de suivi, choisissez View I Watch. Si aucun suivi n'a 
ete defini, la fenetre est vide. 



Figure 6.1 
Fenetre de suivi 



A 
A 



hPrevlnstance: NULL 
nCmdShow: 1 



Ajoutd'un suivi Pour ajouter une variable dans la fenetre de suivi, choisissez Debug I Add 

Watch. L'EDI ouvre la boite de dialogue Watch Properties, dans laquelle 
vous entrez l'expression de suivi. 

Cette fenetre, comme toute fenetre de l'EDI, peut etre librement modifiee. Si 
vous la fermez, vous pourrez la rouvrir en choisissant View I Watch. Si la 
fenetre de suivi est la fenetre active, vous pouvez ajouter un suivi en 
choisissant Add Watch dans le TurboMenu. 

Si la fenetre d'edition est active, vous pouvez rapidement placer expression 
sous le curseur dans la fenetre de suivi en choisissant Set Watch dans le 
TurboMenu. 



Formatage des 
expressions de 
suivi 



Si vous double-cliquez sur un suivi dans la fenetre de suivi (ou si vous 
selectionnez un suivi et choisissez Set Properties dans le TurboMenu de la 
fenetre de suivi), la boite de dialogue Watch Properties s'ouvre. 
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Figure 6.2 
Boite de dialogue 
Watch Properties 
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L' expression par defaut dans cette boite de dialogue est le mot sous le 
curseur dans la fenetre d'edition courante. Les expressions deja entrees sont 
conservees dans un historique. 

Vous pouvez formater les resultats en selectionnant des options dans cette 
boite de dialogue. Par exemple, bien que les valeurs entieres s'affichent 
normalement au format decimal, vous pouvez l'afficher en hexadecimal en 
cliquant sur le bouton correspondant. Vous pouvez aussi modifier le format 
d'une expression a l'aide des options Display as. 

Si vous suivez un tableau ("array"), vous pouvez afficher la valeur des 
elements de donnees consecutifs. Par exemple, si votre tableau compte cinq 
entiers, tapez 5 dans la case Repeat count de la boite de dialogue pour voir 
la valeur des cinq elements du tableau. Une expression utilisee avec un 
compteur de repetitions ("Repeat count") doit representer un seul element 
de donnee. Le debogueur considere l'element de donnee comme le premier 
element d'un tableau si l'element n'est pas un pointeur, et comme un 
pointeur sur un tableau s'il s'agit effectivement d'un pointeur. 

Si vous selectionnez l'option Floating point, vous pouvez aussi indiquer le 
nombre de chiffres significatifs a afficher, en utilisant la case Significant 
digits. 



Deactivation d'un 
suivi 



Si vous desirez arreter momentanement le suivi d'une expression, vous 
pouvez desactiver un suivi. 
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Si l'EDI doit evaluer de nombreuses expressions, il se peut que le trace du 
code soit ralenti. Pour desactiver momentanement un suivi, cliquez sur la 
case a cocher a cote du suivi ; pour le reactiver, cliquez a nouveau sur la case 
a cocher. 

II est egalement possible d'obtenir le meme resultat par le TurboMenu : 
selectionnez un ou plusieurs suivis et choisissez la commande appropriee 
dans le TurboMenu. 



Suppression d'un 
suivi 



Pour supprimer une expression suivie, selectionnez-la et choisissez Delete 
Watch dans le TurboMenu. Pour supprimer tous les suivis, choisissez Delete 
All Watches dans le TurboMenu. 



Modification d'un 
suivi 



Pour modifier les proprietes d'un suivi, ouvrez la boite de dialogue Watch 
Properties de ce suivi et entrez vos modifications. 



Evaluation et 
modification des 
expressions 



Vous pouvez evaluer des expressions a tout moment et modifier la valeur 
des variables au moment de l'execution. 



Evaluation des 
expressions 



Pour evaluer une expression, choisissez Debug I Evaluate /Modify. La boite 
de dialogue Expression Evaluator s'ouvre. Le mot sous le curseur est place 
dans la case Expressions. Vous pouvez editer expression, en entrer une 
nouvelle ou en choisir une dans l'historique. 

La valeur courante de expression selectionnee est affichee dans la case 
Result lorsque vous cliquez sur Evaluate. Vous pouvez evaluer toute 
expression C ou C++ valide, a l'exception de celles qui contiennent les 
elements suivants : 

■ Des symboles ou des macros definis avec #define. 

■ Des variables locales ou statiques en dehors de la portee de la fonction 
executee. 

■ Des appels de fonctions. 

Vous pouvez formater des expressions en ajoutant une virgule et un, ou 
plusieurs, indicateurs de format. Ainsi, pour afficher un resultat en 
hexadecimal, tapez ,H apres expression. Le tableau 6.1 indique quels sont les 
indicateurs de format utilisables, ainsi que leur effet. 
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Tableau 6.1 : Specif icateurs de format des expressions du debogueur 



Caractere Types affectes 



Fonction 



HouX 


Entiers 


C 


Caracteres, chaines 


D 


Entiers 


Fn 


Virgule flottante 


nM 


Tous 



Hexadecimal. Les entiers sont precedes du prefixe Ox, y compris ceux qui appartien- 
nent a des structures de donnees. 

Caractere. Affiche de fagon speciale les caracteres compris entre et 31 . Par defaut, 
ces caracteres sont affiches avec les sequences d'echappement C standards (\n, \t, 
etc.). 

Decimal. Les entiers sont affiches au format decimal, y compris ceux qui appartien- 
nent a des structures de donnees. 

Virgule flottante. Affiche n chiffres significatifs (ou n est compris entre 2 et 18. Valeur 
par defaut :7). 

Dump memoire. Affiche n octets en commengant a I'adresse de expression indiquee. 
Si n n'est pas specifie, il prend par defaut la valeur de la taille (en octets) du type de la 
variable. 

Par defaut, chaque octet est affiche sous la forme de deux chiffres hexadecimal. Les 
specificateurs C, D, H et S peuvent etre utilises avec M pour modifier le formatage des 
octets. 

Pointeur. Affiche les pointeurs sous la forme seg:offset, suivis d'informations sur 
I'adresse pointee. Indique dans quelle zone de la memoire le segment est situe et, si 
utile, le nom de la variable a I'adresse de I'offset. 

Structure/Union. Affiche les noms de champs et les valeurs sous la forme 
X:1;Y:10;Z:5... 

Chafne. Affiche les caracteres ASCII de a 31 sous forme de sequences d'echappe- 
ment C. A n'utiliser que pour modifier les dumps memoire (voir nM 
ci-dessus). 



R 
S 



Pointeurs 

Structures, unions 
Char, chaines 



Modification des 
variables 



Vous pouvez modifier la valeur d'une variable a l'aide de la boite de 
dialogue Expression Evaluator. Entrez la variable dans la case Expression, 
puis tapez la nouvelle valeur dans New Value. Si vous desirez que cette 
nouvelle valeur soit passee a votre programme, cliquez sur Modify. Dans le 
cas contraire, la valeur est ignoree lorsque vous fermez la boite de dialogue. 

Void quelques points a toujours avoir a l'esprit lorsque vous modifiez la 
valeur d'une variable : 

■ Vous pouvez modifier des variables ou des elements de tableaux ou de 
structures, mais non les tableaux, ni les structures elles-memes. 

■ L'expression dans la case New Value doit s'interpreter comme un resultat 
compatible avec sa variable d'affectation : si l'affectation cause une erreur 
de compilation ou d'execution, la modification n'est pas valide. 
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Attention ! 



Vous ne pouvez pas modifier directement les arguments non types passes 
a une fonction, mais vous pouvez les transtyper et leur assigner une 
nouvelle valeur. 

Vous pouvez utiliser la boite de dialogue Expression Evaluator pour 
examiner et modifier des valeurs dans les registres, y compris les registres 
de drapeaux. Par exemple, vous pouvez entrer des expressions telles 
que :_CS,_BX,_FLAGS. Ces valeurs sont des masques de bits. 

Soyez tres prudent lorsque vous modifiez des valeurs, en particulier des 
pointeurs et des indices de tableaux : vous risquez d'ecraser des variables 
et des structures de donnees. 



Visualisation des 
elements de 
donnees 



Vous pouvez visualiser et modifier les valeurs d'un element de donnee dans 
la fenetre d'inspecteur. Pour inspecter un element de donnees : 

1. Choisissez Debug I Inspect pour afficher la fenetre d'inspecteur de 
donnees. 

2. Entrez l'expression a inspecter. 

3. Choisissez Inspect pour afficher une fenetre d'inspecteur. 

Si le point d'execution est dans la portee de cette expression, la valeur 
s'affiche dans la fenetre. Dans le cas contraire, la valeur est indefinie. 

Vous pouvez aussi afficher une fenetre d'inspecteur directement depuis la 
fenetre d'edition : 

1. Placez le curseur sur l'element a inspecter. 

2. Choisissez Inspect dans le TurboMenu ou appuyez sur Entree. 

Si vous choisissez cette methode, l'element de donnee est toujours evalue 
dans la portee de la ligne sur laquelle il apparait. 

Dans un cas comme dans l'autre, l'aspect des donnees dans une fenetre 
d'inspecteur depend du type des donnees. Si, par exemple, vous inspectez 
un tableau, vous voyez une ligne pour chacun de ses membres, avec l'indice 
de tableau du membre. La valeur du membre apparait ensuite, puis la 
valeur en hexadecimal. 

Lorsque vous etes dans une fenetre d'inspecteur, vous pouvez inspecter 
certains elements pour restreindre la vue. Pour ce faire : 

1. Selectionnez l'element a analyser de pres. 

2. Choisissez Inspect dans le TurboMenu, ou appuyez sur Entree. 
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Vous pouvez changer la valeur des elements de l'inspecteur. Pour ce faire : 

1. Selectionnez un element. 

2. Choisissez Change dans le TurboMenu. 

3. Entrez sa nouvelle valeur et cliquez sur OK. 

Si vous inspectez une structure de donnees, il se peut que le nombre 
d'elements affiches soit si grand que vous soyez oblige de faire defiler la 
fenetre d'inspecteur pour voir certaines donnees. Pour faciliter la lecture, 
vous pouvez reduire l'affichage a certains elements. 

Pour n'afficher que certains elements : 

1. Cliquez dans la fenetre d'inspecteur. 

2. Choisissez Range dans le TurboMenu. 

3. Dans la case Start Index, entrez l'indice de 1' element que vous voulez 
voir en premier dans la fenetre. 

4. Dans la case Count, entrez le nombre d'elements a afficher dans la 
fenetre d'inspecteur. 



Examen des Lorsque vous deboguez, vous pouvez afficher la valeur des registres de 

valeurs de registres donnees, de pointeurs, d'indices, de segments et de pointeurs d'instructions, 

ainsi que les parametres du mot ou des drapeaux d'etat. Choisissez View I 

Register pour ouvrir la fenetre Registers. 

Vous pouvez aussi voir les valeurs standards de registres a l'aide de la boite 
de dialogue Expression Evaluator (voir page precedente). 



Tableau 6.2 

Drapeaux CPU de la 

fenetre Registers 



Lettre 



Drapeau 



Carry 

Zero 

Signe 

Depassement 

Parite 

Carry auxiliaire 

Activation d'interrupt 

Direction 
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Le TurboMenu des registres permet de selectionner un format d'affichage 
des valeurs des registres ; choisissez Hexadecimal ou Decimal. Vous pouvez 
aussi choisir les registres 16 bits (mot) ou 32 bits (mot double). 



Points d'arret 



Le point d'arret est l'endroit dans votre code ou vous desirez que le 
programme s'arrete et rende la main au debogueur. II a le meme effet que la 
commande Run to Cursor, mais vous pouvez placer plusieurs points d'arret 
et vous pouvez ne vous arreter a un point d'arret que sous certaines 
conditions. 



Pose de points 
d'arret 



Pour definir un point d'arret dans le code, placez le curseur sur la ligne 
choisie - qui doit contenir du code executable - et choisissez Toggle 
Breakpoint (F5) dans le menu Debug ou dans le TurboMenu de la fenetre 
d'edition. La ligne passe en surbrillance. 

Dorenavant, lorsque vous executez votre programme dans l'EDI, il s'arrete 
lorsqu'il arrive sur cette ligne (sans l'executer). La ligne s'affiche dans la 
fenetre d'edition, et le point d'execution est place dessus. Vous pouvez alors 
lancer toute operation de debogage : pas a pas, trace, suivi, inspection ou 
evaluation. 

Pour effacer un point d'arret, placez le curseur sur la ligne le contenant et 
appuyez sur F5. 



Utilisation des 
points d'arret 



L'EDI memorise tous vos points d'arret lors d'une session de debogage et 
les associe a votre projet courant. Vous pouvez garder la trace de tous vos 
points d'arret dans une seule fenetre, ce qui facilite leur utilisation. 
Choisissez View I Breakpoint pour afficher la fenetre des points d'arret. 



Figure 6.3 

Fenetre des points 

d'arret 



Fl 


Breakpoints 




▼ 


A. 


Filename 


Line 


State Pass 




WHELLOCPP 


68 


Verified 1 
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Dans cette fenetre, vous pouvez definir et visualiser les proprietes des 
points d'arret. Double-cliquez sur un point d'arret pour afficher la boite de 
dialogue Breakpoint Properties. 



Figure 6.4 

Boite de dialogue 

Breakpoint 

Properties 



Breakpoint Properties 



Filename: 



MPLESVW NDOWS\WHELLO\WHELLO CP 



s 



Line Number: 1 68 



IS 



State: Verified 



| Enable conditional breakpoint 

Conditional Expression: 



IS 



Pass Count: 1 1 


ILil 






Actions: 
£| Break 
| Log expression 


Expression to Lofl: 






IS 









OK 



L Cancel 



Help 



Suppression de 
points d'arret 



Desactiver et 
activer les points 
d'arret 



Pour supprimer un point d'arret, selectionnez-le dans la fenetre Points 
d'arret et choisissez Delete Breakpoint dans le TurboMenu. Pour les 
supprimer tous, choisissez Delete All. 

Vous pouvez aussi utiliser les commandes equivalentes du TurboMenu des 
Breakpoint Properties. 

II est possible de desactiver momentanement un point d'arret en 
deselectionnant la case a cocher du point d'arret en question dans le fenetre 
Breakpoint. Pour le reactiver, cochez a nouveau cette case. 

Vous pouvez aussi utiliser les commandes du TurboMenu. Pour en 
desactiver ou en activer plusieurs en meme temps, faites glisser la souris 
dessus pour les selectionner dans la fenetre Breakpoint (ou appuyez sur Ctrl 
en cliquant sur l'un apres l'autre), puis choisissez la commande appropriee 
dans le TurboMenu. 



134 



Borland C++ Guide de I'utilisateur 



Visualisation et 
modification du 
code sous un point 
d'arret 



Meme si le point d'arret recherche n'est pas affiche dans la fenetre active, il 
est facile et rapide de positionner le curseur dessus : selectionnez-le dans la 
fenetre Breakpoint puis choisissez View Source dans le TurboMenu. La 
fenetre Breakpoint reste la fenetre active a l'ecran. 

Si vous desirez editer le code source du point d'arret, choisissez plutot Edit 
Source dans le TurboMenu de la fenetre Breakpoint. 



Reinitialisation de 
points d'arret 
incorrects 



Un point d'arret, pour etre valide, doit etre place sur du code executable. Si 
vous placez un point d'arret sur un commentaire, une ligne vierge ou une 
declaration, le debogueur vous signale l'erreur en affichant la boite de 
dialogue Invalid Breakpoint lors de l'execution du programme. Ouvrez 
alors la fenetre des points d'arret et supprimez le point d'arret errone. 

Vous pouvez aussi choisir d'ignorer ce message, refermer la boite de 
dialogue et continuer l'execution de votre programme. L'EDI desactive alors 
le point d'arret en question. 



Visualisation et 
modification des 
proprietes d'un 
point d'arret 



Pour visualiser et modifier les proprietes d'un point d'arret, faites un 
double-clic dessus et choisissez Edit Breakpoint dans le TurboMenu. La 
boite de dialogue Breakpoint Properties s'ouvre. 

Outre examiner les proprietes d'un point d'arret, vous pouvez ici en definir 
un nouveau, en modifier un ou rendre un point d'arret conditionnel. 

Les sections qui suivent decrivent comment proceder. 

Pose d'un point d'arret 

L'option Toggle Breakpoint du TurboMenu de la fenetre d'edition est la 
facon la plus simple de poser un point d'arret. Si vous desirez poser un 
point d'arret conditionnel, cependant, utilisez la boite de dialogue 
Breakpoint Properties : 

1. Placez le curseur a l'endroit ou vous desirez poser le point d'arret. 

2. Choisissez Add Breakpoint dans le menu Debug ou dans le TurboMenu 
de la fenetre Points d'arret. 

La boite de dialogue Breakpoint Properties s'affiche. 
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Pour poser un point d'arret dans un fichier non ouvert : 

1. Dans la boite de dialogue Breakpoint Properties, entrez le nom du fichier 
en question. 

2. Dans la case Line Number, entrez le numero de la ligne de code source 
sur laquelle vous desirez placer le point d'arret. 

Modification d'un point d'arret 

Vous pouvez modifier un point d'arret existant en changeant ses proprietes 
dans la boite de dialogue Breakpoint Properties. 

Pose de points d'arret apres le lancement du programme 

Lorsque votre programme s'execute, vous pouvez passer dans le debogueur 
et poser un point d'arret. Au retour dans votre application, ce nouveau 
point d'arret sera operationnel. 

Points d'arret conditionnels 

Les points d'arret poses avec la commande Toggle Breakpoint du 
TurboMenu de la fenetre d'edition sont inconditionnels : des qu'il arrive sur 
la ligne en question, le debogueur s'arrete. Cependant, lorsque vous editez 
un point d'arret, vous disposez d'options dans la boite de dialogue 
Breakpoint Properties vous permettant de creer des points d'arret 
conditionnels. Vous pouvez definir deux types de conditions pour les points 
d'arret : des expressions booleennes ou un compteur de passages. 

Vous pouvez utiliser une expression booleenne comme condition pour un 
point d'arret. Vous pouvez, par exemple, tester si une variable est comprise 
dans une certaine fourchette de valeurs, ou si un drapeau est active. Si la 
condition specifiee est vraie, le debogueur s'arrete et vous donne la main. 

En specifiant un nombre de passages sur un point d'arret, vous indiquez au 
debogueur qu'il ne doit s'arreter au point d'arret que lorsque la condition 
est vraie pour la xieme fois. Si vous ne specif iez pas de condition, le 
debogueur s'arrete a chaque passage sur le point d'arret. 

Consignation des Vous pouvez faire en sorte que la valeur d'une expression soit ecrite dans la 
expressions fenetre Event Log a chaque fois qu'un point d'arret est atteint : 

1. Selectionnez Log Expression dans la boite de dialogue Breakpoint 
Properties. 

2. Dans la case Expression to Log, entrez l'expression a evaluer. 
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Par exemple, si vous entrez le nom d'une variable dans la boite Expression 
to Log de la boite de dialogue Breakpoint Properties, le debogueur ecrit la 
valeur de cette expression dans la fenetre Event Log lorsqu'il atteint le point 
d'arret. 

Pour de plus amples informations sur la fenetre Event Log, voir la section 
"Utilisation de la fenetre Event Log". 



Personnalisation 
des points d'arret 
et du point 
d'execution 



Vous pouvez utiliser des couleurs pour marquer les points d'arret actives, 
desactives et incorrects : 

1. Choisissez Options I Environment puis Syntax Highlighting I 
Customize Syntax Highlighting. 

2. Dans la liste des elements, selectionnez le point d'arret a modifier puis 
choisissez la couleur de fond et de premier plan. 

Voir la section "Mise en surbrillance de la syntaxe" du chapitre 1 pour de 
plus amples informations sur la mise en couleur de la syntaxe. 

Procedez de meme pour modifier la couleur du point d'execution. 



Gestion des erreurs GPF 



Si une erreur GPF (General Protection Fault, Erreur de protection generale) 
se produit lorsque vous executez votre programme dans l'EDI, votre 
programme s'arrete et la boite de dialogue General Protection s'affiche. Si 
vous cliquez sur OK pour fermer la boite de dialogue, le debogueur affiche 
le code responsable de l'erreur dans la fenetre d'edition. Le point 
d'execution est positionne sur la partie du code qui est en faute. 

Choisissez Debug I Terminate Program pour que votre programme ne se 
bloque pas, puis corrigez l'erreur et relancez le programme. 

Le debogueur sait intercepter la majorite des GPF ; nous ne saurions 
garantir, toutefois, qu'il les intercepte toutes. 
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Utilisation de la fenetre Event Log 



Pour afficher la fenetre Event Log, choisissez View I Event Log. 

Dans la section precedente, vous avez appris a consigner la valeur de 
certaines expressions dans la fenetre Event Log. 

Vous pouvez aussi consigner des messages de fenetres et de sortie dans la 
fenetre Event Log. Pour selectionner les evenements a consigner, choisissez 
Set Options dans le TurboMenu de la fenetre Event Log. Selectionnez le 
sujet Debugger puis selectionnez des options Event Capture. 

Le tableau ci-dessous decrit toutes les commandes du TurboMenu de la 
fenetre Event Log : 



Tableau 6.3 
TurboMenu de la 
fenetre Event Log 



Commande Description 

Save Events to File Affiche une boite de dialogue dans laquelle vous specifiez un nom 

de fichier. Tous les evenements affiches dans la fenetre Event Log 
sont alors enregistres dans ce fichier, ce qui vous permet de les 
visualiser ulterieurement. 

Add Comment Vous permet d'entrer une ligne de commentaire. Ce texte est ensuite 

insere dans la fenetre Event Log. 

Clear Events Efface la fenetre Event Log. 

Set Options Affiche la boite de dialogue Environment Options, qui vous permet 

de selectionner les options du debogueur et de definir certaines 
options de capture des evenements ("Event Capture"). 



Debogage des DLL 



Lorsque vous deboguez une DLL en mode pas a pas ou en mode suivi, le 
debogueur charge automatiquement sa table des symboles (la liste servant a 
memoriser les variables, constantes, types et fonctions utilises dans la DLL). 

Etant donne qu'il est impossible de charger plusieurs tables des symboles en 
memoire en meme temps, la table des symboles de votre fichier .EXE est 
dechargee lorsque celle de la DLL est chargee. Vous ne pouvez done pas 
suivre les variables, inspecter les donnees, etc, du code de votre .EXE. Vous 
pourrez le faire, bien entendu, sur le code de la DLL. 
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Pour savoir quelle table des symboles est utilisee par le debogueur, 
choisissez Debug I Load Symbol Table ; la liste de la table courante (et des 
autres tables eventuellement disponibles) s'affiche a l'ecran. Si, par exemple, 
votre EXE s'appelle MONAPPLI.EXE et utilise la DLL appelee 
MADLL.DLL, lorsque vous deboguez la DLL, MADLL.DLL est listee 
comme table des symboles courante et MONAPPLI.EXE est listee comme 
table des symboles disponible. 

II est possible de passer d'une table des symboles a une autre. Par exemple, 
si vous executez pas a pas MADLL.DLL et que vous souhaitez examiner la 
valeur d'une variable de MONAPPLI.EXE; vous pouvez le faire en 
chargeant la table des symboles de MONAPPLI.EXE : 

1. Choisissez Debug I Load Symbol Table. 

2. Dans la liste des tables disponibles, choisissez la table a charger. 

N'oubliez pas de revenir a la table originale lorsque vous avez fini votre 
etude de cette nouvelle table. 



Debogage en mode soft et en mode hard 



Windows traite et genere continuellement des messages. Tout programme 
Windows actif (tel que Borland C++ pour Windows) doit faire de meme. 
Vos propres programmes, lorsqu'ils s'executent, envoient des messages et 
gerent ceux qu'ils recoivent. 

Lorsque vous posez un point d'arret dans votre code, cependant, vous 
desirez que votre programme s'interrompe a ce point d'arret. Mais, dans 
l'environnement Windows, le simple fait de modifier une fenetre, d'ouvrir 
une boite de dialogue, de deplacer le pointeur de la souris ou d'ouvrir un 
menu genere des messages qui sont envoyes a votre programme en cours 
d'execution. Si le debogueur ne gerait pas ces messages pour vous, ils 
pourraient forcer votre programme a s'executer, et meme, dans des cas 
extremes, bloquer votre ordinateur. 

Heureusement, le debogueur integre se charge de ces problemes pour vous, 
ce qui vous permet de deboguer votre programme tout en profitant de 
toutes les fonctionnalites de Windows. Lorsque le debogueur fonctionne en 
meme temps que d'autres programmes Windows, on dit qu'il est en mode 

soft . 
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A cause de certaines limites de Windows, il se peut que vous deviez 
interrompre tout autre programme que le debogueur. Ce mode s'appelle le 
mode hard. Lorsque le debogueur est dans ce mode, vous n'avez pas acces a 
diverses fonctionnalites de Windows. Vous ne pourrez pas, par exemple, 
passer d'une tache a une autre. Le debogueur considere qu'il est le seul 
programme en memoire. 

Vous deboguerez vos programmes en mode hard s'ils envoient des 
messages inter-taches (des messages DDE, par exemple) ou si vous voulez 
un debogage de tres bas niveau. Pour passer en mode hard : 

1. Choisissez Options I Environment ; la boite de dialogue Environment 
Options s'ouvre. 

2. Choisissez Debugger. 

3. Cochez l'option Hard Mode on All Stops. 

Si l'option Smart est cochee, le debogueur choisit entre le mode soft et hard 
en fonction des evenements qu'il detecte dans l'environnement Windows. 
Nous vous recommandons d'utiliser cette option. Pour ce faire : 

1. Choisissez Options I Environnement. 

2. Choisissez Debugger. 

3. Selectionnez l'option Smart. 
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WinSight 



WinSight est un outil de debogage qui vous permet de visualiser des 
informations au sujet des fenetres, des classes de fenetres et des messages. 
Utilisez-le pour etudier une application Windows, pour voir comment les 
fenetres et les classes de fenetres sont creees et exploiters, ainsi que pour 
visualiser tous les messages qui sont transmis d'une fenetre a l'autre. 

Vous pouvez configurer WinSight pour visualiser les messages suivants : 

■ par fenetre ; 

■ par classe de fenetre ; 

■ par type de message ; 

■ selon une combinaison des trois criteres ci-dessus. 

Sachez que WinSight est un outil passif : il intercepte et affiche de 
l'information au sujet des messages mais il n'empeche pas la transmission 
des messages d'une application a l'autre. 



Demarrage de WinSight 




WinSight 



II suffit de double-cliquer l'icone WinSight pour faire apparaitre sa fenetre 
principale dans la configuration standard. Dans cette configuration, la 
fenetre affiche la liste de toutes les fenetres actives sur le bureau. Lorsque 
vous quittez WinSight, la configuration de travail est automatiquement 
enregistree. 

WinSight comporte trois volets qui peuvent apparaitre dans la fenetre 
principale : une arborescence de fenetres (Window Tree), une liste de classes 
(Class List) et un trace de messages (Message Trace). Pour modifier 
l'emplacement et la dimension des volets, choisissez View I Split Horizontal 
ouView I Split Vertical. 
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Activation et 
deactivation de la 
miseajour 



Deactivation du 
trace des messages 



Vous pouvez specifier quels messages doivent etre traces par WinSight (voir 
plus loin), et a quel moment le trace doit etre active et desactive. Les sections 
qui suivent decrivent toutes ces fonctions en detail. 

Pour activer le trace, choisissez Start! dans le menu (cette option se 
transforme alors en Stop!). En regie generale, les trois vues sont conservees 
lors de l'enregistrement des classes, lors de la creation ou de la destruction 
des fenetres, et lors de la reception des messages. Vous pouvez cependant, 
en choisissant Messages I Trace Off, suspendre le trace des messages 
uniquement. La liste des classes et l'arborescence des fenetres seront 
toujours mis a jour. 

Utilisez Stop! et Start! pour : 

■ Etudier une situation particuliere 

■ Minimiser les ressources utilisees par WinSight lorsqu'il met constamment 
les informations a jour. 

Pour desactiver le trace du type des messages, choisissez Messages I Trace 
Off. La vue du trace des messages reste a l'ecran, et le trace reprend lorsque 
vous choisissez Messages I Selected Classes, Selected Windows ou All 
Windows (il faut pour cela que le trace soit active). 

Les sections qui suivent expliquent comment utiliser les trois vues pour 
obtenir les donnees necessaires au debogage de votre application. Pour 
quitter WINSIGHT, choisissez Spy I Exit. 
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Choix d'une vue 



WinSight comporte trois volets qui peuvent apparaitre dans la fenetre 
principale : une arborescence de fenetres (Window Tree), une liste de classes 
(Class List) et un trace de messages (Message Trace). Vous pouvez visualiser 
un seul ou tous les volets. WinSight redistribue automatiquement les volets 
par un effet de mosai'que au sein de la fenetre principale. 

■ Le volet Window Tree presente la hierarchie des fenetres sur le bureau. II 
correspond a l'affichage standard au demarrage de WinSight. 

■ Le volet Class List montre toutes les classes de fenetres actuellement 
recensees au niveau du systeme. 

■ Le volet Message Trace affiche des informations au sujet des messages 
recus par les fenetres ou les classes de fenetres selectionnees. 

■ Pour de plus amples informations sur les elements au sein des volets 
Window Tree et Class List : 



Vous pouvez montrer 

ou cacher n'importe 

quel volet a tout 

moment au moyen des 

commandesdu menu 

View. Les informations 

et les selections ne 

sont pas perdues 

lorsqu'un volet est 

cache. 



■ Selectionnez une fenetre ou une classe puis choisissez Spy I Open Detail. 

■ Double-cliquez sur une fenetre ou une classe. 

La fenetre Window Detail donne des informations detaillees au sujet de 
cette fenetre, informations qui viennent en complement de celles de la classe 



de fenetres. 



Liste des classes 



Une classe est le nom 

sous lequel la fenetre 

de classe a ete 

enregistree aupres de 

Windows. 

Utilisation du volet 
Liste de classes 



Parfois, au lieu de choisir quelles fenetres tracer, vous desirez voir les 
messages de classes entieres de fenetres. Ceci est faisable grace au volet Liste 
de classes. 



Le volet Liste de classes montre toutes les classes de fenetre actuellement 
recensees au niveau Windows. Vous pouvez obtenir des details au sujet 
d'une classe en double-cliquant son nom ou en validant par Entree 
lorsqu'elle est selectionnee. 

Les losanges a cote des classes deviennent noirs lorsque la fenetre recoit un 
message. Si une fenetre enfant cachee recoit un message, le losange de son 
parent change de couleur. 
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Format Classe (Module) Fonction Styles 

Classe est le nom de la classe. Certaines classes Windows predefinies ont un 
code numerique (la classe des menus Popup, par exemple, a le code 32768). 
Ces classe predefinies sont indiquees avec leur nom et leur code 
(#32768 :PopupMenu, dans ce cas). Le nom de la classe n'est alors que sa 
valeur numerique, qui utilise le format MAKEINTRESOURCE, egalement 
utilise pour les identificateurs de ressources. 

Module est le nom du module executable (.EXE ou .DLL) ayant enregistre la 
classe. 

Fonction est l'adresse de la fonction de fenetre de classe. 

Style est la liste des "cs_styles" de la classe. Les noms sont les memes que 
ceux des "cs_definitions" des WinTypes, mais les caracteres "cs_" sont 
supprimes et le nom comporte a la fois des minuscules et des majuscules. 



Trace des classes Pour tracer des classes, selectionnez-les dans la Liste des classes (par Maj+Clic 
ou Ctrl+Clic), puis choisissez Messages I Selected Classes. Si le volet Message 
Trace est masque a ce moment-la, il redevient visible. 

Le fait de tracer des messages vers une classe vous permet de voir tous les 
messages a destination des fenetres de cette classe, notamment les messages 
de creation, qui resteraient sinon invisibles. 

Pour tracer une autre classe, selectionnez-en une autre dans la Liste de 
classes. Choisissez Messages I Trace Off pour desactiver le trace des 
messages en direction du volet Message. 

Arborescence de fenetres 

L'arborescence de fenetres affiche la hierarchie de toutes les fenetres 
presentes sur le bureau. Ceci vous permet de : 

■ Connaitre le statut des fenetres, y compris de celles qui sont cachees. 

■ Savoir quelles fenetres recoivent des messages. 

■ Selectionner des fenetres pour le trace des messages. 



1 44 Borland C++ Guide de I'utilisateur 



Les traits a gauche de l'arborescence montrent sa structure. Chaque fenetre 
est reliee a son parent, a ses descendants et a ses enfants par ces traits. Le 
losange place a cote de chaque fenetre indique si la fenetre a des enfants. 
Lorsqu'une fenetre recoit un message, son losange (ou le losange de sa 
fenetre parent si l'arborescence est condensee) devient noir. 

\y La fenetre n'a pas d'enfants. 

<£> La fenetre a des enfants mais ils ne sont pas affiches. Pour voir le niveau 

d'enfants suivants, cliquez sur le losange a cote de la fenetre. Pour voir tous 
les niveaux des fenetres enfants (les enfants des enfants, etc.), cliquez, avec 
le bouton droit, sur le losange. 

<^> La fenetre a des enfants, et ceux-ci sont affiches (un niveau au moins Test). 

Pour masquer toutes les fenetres enfants, cliquez (ou double-cliquez) sur le 
losange a cote de la fenetre. 

Format Pointeur (Classe) Module Position "Titre" 

Pointeur est le pointeur de la fenetre retourne par CreateWindow. 

Classe est le nom de la classe, decrit dans le volet Class List. 

Module est le nom du module executable (.EXE ou .DLL) ayant cree la 
fenetre. II s'agit du nom du module auquel appartient le segment de 
donnees passe comme parametre Instance a CreateWindow. 

Position est "hidden" (masque) si la fenetre est masquee. Dans le cas 
contraire, Position est specifie en utilisant les coordonnees ecran (pour les 
fenetres parents) ou les coordonnees dans la zone client du parent (pour les 
fenetres enfants). Le format de Position est le suivant : 

xBegin, yBegin- xEnd, yEnd 

Titre est le titre de la fenetre, retourne par GetWindowText ou un message 
wm_GETTEXT. S'il s'agit d'une chaine vide, les guillemets sont omis. 



Recherche d'une 
fenetre 



WinSight a un mode propre de recherche de fenetres. II peut s'utiliser de 
deux facons : soit en identifiant la ligne de l'arborescence de fenetres qui 
correspond a la fenetre sur laquelle vous pointez, soit en mettant en 
surbrillance la fenetre que vous selectionnez dans l'arborescence de fenetres. 
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Important ! Lorsque 

vous etes en mode de 

recherche de fenetre, 

toutes les autres taches 

sont interrompues. 



Passez en mode de recherche de fenetre en choisissant Spy I Find Window. 
Dans ce mode, des que la souris passe sur une fenetre, une bordure epaisse 
entoure cette fenetre et elle est selectionnee dans l'arborescence de fenetres. 

De plus, une fois en mode recherche, vous pouvez selectionner des fenetres 
dans l'arborescence avec la souris ou les touches de deplacement pour 
obtenir le meme effet. Si vous appuyez sur Entree, la fenetre Window Detail 
s'ouvre. 



Sortie du mode de 
recherche de 
fenetres 



Une fois que vous avez localise la fenetre de votre choix, vous pouvez sortir 
du mode recherche en cliquant ou en appuyant sur Echap. La bordure 
s'efface et la description de la fenetre courant reste selectionnee dans 
l'arborescence. 



Trace des fenetres 



Pour analyser une ou plusieurs fenetres, selectionnez-les (avec la souris et 
les touches Maj ou Ctrl) puis choisissez Messages I Selected Windows. Pour 
tracer d'autres fenetres, selectionnez d'autres fenetres dans l'arborescence. 

Pour analyser toutes les fenetres, quelle que soit la selection dans la Liste des 
classes ou dans l'arborescence, choisissez Messages I All Windows. 

Le Trace des messages devient visible si vous choisissez Messages I Selected 
Windows ou Windows I All Windows. 

Choisissez Messages I Trace Off pour desactiver le trace des messages sans 
masquer la fenetre Message Trace. 



Choix des messages a tracer 



Le Trace des messages affiche les messages recus par les classes de fenetres 
ou par les fenetres selectionnees. Les messages recus via SendMessage sont 
indiques deux fois : quand ils sont envoyes et lorsqu'ils sont retournes pour 
montrer la valeur de retour. 

Les messages envoyes ne sont affiches qu'une fois, leur valeur de retour 
etant sans importance. L'affichage est mis en retrait pour montrer 
l'imbrication des messages. 
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Utilisation du volet 
Trace de messages 



Autres options de 
trace 



Par defaut, WINSIGHT trace tous les messages et les affiche dans le volet 
Trace de messages. II existe plusieurs facons de restreindre le trace des 
messages : 

■ Choisissez Messages I Selected Classes ou Messages I Selected Windows 
puis selectionnez des classes (dans la liste des classes) ou des fenetres 
(dans l'arborescence de fenetres) avec la souris et les touches Maj ou Ctrl. 

■ Choisissez Message I All Windows. 

■ Choisissez Message I Options puis selectionnez un ou plusieurs groupes 
de messages (ces groupes sont decrits aux tableaux 7.1 a 7.14). Cochez All 
Messages dans la boite de dialogue Options pour reactiver le trace de tous 
les messages. 

La boite de dialogue Message Trace Options vous permet de changer le 
format des messages, ainsi que de les rediriger sur une imprimante, dans un 
fichier ou vers un moniteur ou une fenetre auxiliaire. 

■ Normalement, le Trace des messages interprete les parametres de chaque 
message et les affiche dans un format lisible (l'option Interpret Values est 
cochee). Cochez Hex Values si vous desirez voir les parametres de 
messages sous forme de valeurs hexadecimales de wPamm et de War am. 

■ Les informations sur les messages traces s'affichent normalement dans le 
volet de Trace des messages. II est possible, cependant, de les rediriger sur 
une imprimante, dans un fichier ou vers un moniteur auxiliaire en cochant 
Log File dans la boite de dialogue Message Trace Options et en faisant 
l'une des operations ci-dessous : 

• Entrez le nom du fichier journal, s'il existe deja, les messages lui sont 
ajoutes. 

• Entrez le nom du peripherique (PRN, par exemple) sur lequel les sorties 
doivent etre redirigees. 

• Entrez AUX pour rediriger les sorties sur un moniteur ou une fenetre 
auxiliaire. Pour pouvoir faire ceci, WINOX.SYS ou OX.SYS doivent etre 
installes comme peripheriques dans votre CONFIG.SYS. 

Pour arreter la redirection des sorties, deselectionnez Log File dans la 
boite de dialogue Message Trace Options. 

Format Pointeur ["Titre" ou {Classe}] Message Etat 

Pointeur est le pointeur de la fenetre recevant le message. 
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Titre est le titre de la fenetre. S'il s'agit d'une chaine vide, la classe est 
indiquee entre accolades. 

Message est le nom du message defini par Windows. Ces noms sont affiches 
en majuscules par WINSIGHT. Les messages connus non documented sont 
affiches en minuscules. Les numeros de messages inconnus definis par 
l'utilisateur) sont indiques sous la forme wm_User+OxXXXX s'ils sont 
superieurs ou egaux a wm_User, et sous la forme wm_0xXXX s'ils sont 
inferieurs a wmjdser. Le nom de l'identificateur des messages enregistres 
est place entre guillemets simples. 

Etat peut prendre l'une des valeurs suivantes : 

■ Dispatched si le message a ete recu via DispatchMessage. 

■ Sent [from XXXX] si le message a ete recu via SendMessage. S'il provient 
d'une autre fenetre, from XXXX indique le pointeur de cette fenetre. Si 
l'emetteur et le recepteur sont la meme fenetre, cette chaine devient 
from sel f . Si le message a ete envoye par Windows, le mot "from" est 
omis. 

■ Returns si le message a ete recu via SendMessage et est maintenant en 
phase de retour. 

■ II se peut que d'autres messages incluent une valeur de retour numerique 
ou un message textuel tel que wm_GetText. Pour les messages envoyes et 
expedies (Sent et Dispatched), WINSIGHT interprete les parametres et les 
affiche de facon lisible. Si un message est associe a des structures de 
donnees (wm_Create, par exemple), WINSIGHT inclut ces structures dans 
les informations qu'il affiche. 
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Tableau 7.1 : Messages souris 



WMJHSCROLL 

WM_LBUTTONDBLCLK 

WM_LBUTTONDOWN 

WM_LBUTTONUP 

WM_MBUTTONDBLCLK 

WM MBUTTONDOWN 



WM_MBUTTONUP 

WM_MOUSEACTIVATE 

WM_MOUSEFIRST 

WM_MOUSELAST 

WM_MOUSEMOVE 

WM RBUTTONDBLCLK 



WM_RBUTTONDOWN 
WM_RBUTTONUP 
WM_SETCURSOR 
WM VSCROLL 



Tableau 7.2 : Messages fenetres 

WM_ACTIVATE 

WM_ACTIVATEAPP 

WM_CANCELMODE 

WM_CHILDACTIVATE 

WM_CLOSE 

WM_CREATE 

WM_CTLCOLOR 

WM_DDE_FIRST 

WM_DESTROY 

WM_ENABLE 

WM_ENDSESSION 

WM ERASEBKGND 



WM_GETDLGCODE 

WM_GETFONT 

WM_GETMINMAXINFO 

WM_GETTEXT 

WM_GETTEXTLENGTH 

WMJCONERASEBKGND 

WM_KILLFOCUS 

WM_MOVE 

WM_PAINT 

WM_PAINTICON 

WM_QUERYDRAGICON 

WM QUERYENDSESSION 



WM_QUERYNEWPALETTE 

WM_QUERYOPEN 

WM_QUIT 

WM_SETFOCUS 

WM_SETFONT 

WM_SETREDRAW 

WM_SETTEXT 

WM_SHOWWINDOW 

WM_SIZE 

WM_WINDOWPOSCHANGED 

WM WINDOWPOSCHANGING 



Tableau 7.3 : Messages clavier 



WM_CHAR 

WM_CHARTOITEM 

WM_COMMAND 

WM_DEADCHAR 

WM_KEYDOWN 

WM KEYLAST 



_KEYUP 
_MENUCHAR 
_MENUSELECT 
_PARENTNOTIFY 
_SYSCHAR 
SYSDEADCHAR 



WM_SYSKEYDOWN 

WM_SYSKEYUP 

WMJIMER 

WM VKEYTOITEM 



Tableau 7.4 : Messages systeme 



WM_COMPACTING 
WM_DEVMODECHANGE 
WM_ENTERIDLE 
WM_FONTCHANGE 
WM NULL 



_PALETTECHANGED 
_PALETTEISCHANGING 
_POWER 
_QUEUESYNC 
SPOOLERSTATUS 



_SYSCOLORCHANGE 
_SYSCOMMAND 
JIMECHANGE 
WININICHANGE 



Tableau 7.5 : Messages d'initialisation 



WM INITDIALOG 



WM INITMENU 



WM INITMENUPOPUP 
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Tableau 7.6 : Messages du presse-papiers 



WM_ASKCBFORMATNAME 

WM_CHANGECBCHAIN 

WM_CLEAR 

WM_COPY 

WM CUT 



WM_DESTROYCLIPBOARD 
WM_DRAWCLIPBOARD 
WM_HSCROLLCLIPBOARD 
WM_PAINTCLIPBOARD 
WM PASTE 



_RENDERALLFORMATS 
_RENDERFORMAT 
_SIZECLIPBOARD 
_UNDO 
VSCROLLCUPBOARD 



Tableau 7.7 : Messages DDE 

WM_DDE_ACK 
WM_DDE_ADVISE 
WM DDE DATA 



DDE_EXECUTE 
_DDE_INITIATE 
DDE POKE 



DDE_REQUEST 
DDEJERMINATE 
DDE UNADVISE 



Tableau 7.8 : Messages non clients 

WM_NCACTIVATE 

WM_NCCALCSIZE 

WM_NCCREATE 

WM_NCDESTROY 

WM_NCHITTEST 

WM NCLBUTTONDBLCLK 



WM_NCLBUTTONDOWN 

WM_NCLBUTTONUP 

WM_NCMBUTTONDBLCLK 

WM_NCMBUTTONDOWN 

WM_NCMBUTTONUP 

WM NCMOUSEMOVE 



_NCPAINT 

_NCRBUTTONDBLCLK 
_NCRBUHONDOWN 
NCRBUTTONUP 



Tableau 7.9 : Messages d'impression 



DM_COLOR 

DM_COPIES 

DM_COPY 

DM_DEFAULTSOURCE 

DM_DUPLEX 

DM_IN_BUFFER 

DM IN PROMPT 



DM_MODIFY 

DM_ORIENTATION 

DM_OUT_BUFFER 

DM_out_default 

DM_paperlength 

DM_papersize 

DM_paperwidth 



DM_printquality 

DM_prompt 

DM_scale 

DM_specversion 

DMjtoption 

DM_update 

DM_yresolution 
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Tableau 7.10 : Messages de controle 



BM_GETCHECK 

BM_GETSTATE 

BM_SETCHECK 

BM_SETSTATE 

BM_SETSTYLE 

BN_CLICKED 

BN_DISABLE 

BN_DOUBLECLICKED 

BN_HILITE 

BN_PAINT 

BN_UNHILITE 

CB_ADDSTRING 

CB_DELETESTRING 

CB_DIR 

CB_FINDSTRING 

CB_FINDSTRINGEXACT 

CB_GETCOUNT 

CB_GETCURSEL 

CB_GETDROPPEDCONTROLRECT 

CB_GETDROPPEDSTATE 

CB_GETEDITSEL 

CB_GETEXTENDEDUI 

CB_GETITEMDATA 

CB_GETITEMHEIGHT 

CB_GETLBTEXT 

CB_GETLBTEXTLEN 

CBJNSERTSTRING 

CB_LIMITTEXT 

CB_MSGMAX 

CB_RESETCONTENT 

CB_SELECTSTRING 

CB_SETCURSEL 

CB_SETEDITSEL 

CB_SETITEMDATA 

CB_SETITEMHEIGHT 

CB_SHOWDROPDOWN 

CBN_CLOSEUP 

CBN_DBLCLK 

CBN_DROPDOWN 

CBN_EDITCHANGE 

CBN_EDITUPDATE 

CBN_ERRSPACE 

CBN KILLFOCUS 



CBN_SELCHANGE 

CBN_SELENDCANCEL 

CBN_SETFOCUS 

DM_GETDEFID 
DM_SETDEFID 

EM_CANUNDO 

EM_EMPTYUNDOBUFFER 

EM_FMTLINES 

EM_GETFIRSTVISIBLELINE 

EM_GETHANDLE 

EM_GETUNE 

EM_GETLINECOUNT 

EM_GETMODIFY 

EM_GETPASSWORDCHAR 

EM_GETRECT 

EM_GETSEL 

EM_GETTHUMB 

EM_GETWORDBREAKPROC 

EM_LIMITTEXT 

EM_LINEFROMCHAR 

EM_LINEINDEX 

EMJJNELENGTH 

EM_LINESCROLL 

EM_MSGMAX 

EM_REPLACESEL 

EM_SCROLL 

EM_SETFONT 

EM_SETHANDLE 

EM_SETMODIFY 

EM_SETPASSWORDCHAR 

EM_SETRECT 

EM_SETRECTNP 

EM_SETSEL 

EM_SETTABSTOPS 

EM_SETWORDBREAK 

EM_UNDO 

EN_CHANGE 

EN_ERRSPACE 

EN_HSCROLL 

EN_KILLFOCUS 

EN_MAXTEXT 

EN_SETFOCUS 

EN UPDATE 



EN_VSCROLL 

LB_ADDSTRING 

LB_DELETESTRING 

LB_DIR 

LB_FINDSTRING 

LB_FINDSTRINGEXACT 

LB_GETCAREINDEX 

LB_GETCOUNT 

LB_GETCURSEL 

LB_GETHORIZONTALEXTENT 

LB_GETITEMDATA 

LB_GETITEMHEIGHT 

LB_GETITEMRECT 

LB_GETSEL 

LB_GETSELCOUNT 

LB_GETSELITEMS 

LB_GETTEXT 

LB_GETTEXTLEN 

LB_GETTOPINDEX 

LBJNSERTSTRING 

LB_MSGMAX 

LB_RESETCONTENT 

LB_SELECTSTRING 

LB_SELITEMRANGE 

LB_SETCARETINDEX 

LB_SETCOLUMNWIDTH 

LB_SETCURSEL 

LB_SETHORIZONTALEXTENT 

LB_SETITEMDATA 

LB_SETITEMHEIGHT 

LB_SETSEL 

LB_SETTABSTOPS 

LB_SETTOPINDEX 

LBN_DBLCLK 

LBN_KILLFOCUS 

LBN_SELCANCEL 

LBN_SELCHANGE 

LBN_SETFOCUS 

STM_GETICON 
STM SETICON 
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Tableau 7.1 1 : Messages stylo 



WIN USER 


WM HOOKRCRESULT 


WM RCRESULT 


WM GLOBALRCCHANGE 


WM PENWINFIRST 


WM SKB 


WMJHEDITCTL 


WM PENWINLAST 




Tableau 7.12 : Messages multimedia 


MM ADLIB 


MM MIM CLOSE 


MM SNDBLST MIDIIN 


MM J0Y1 BUTTON DOWN 


MM MIM DATA 


MM SNDBLST MIDIOUT 


MM JOY1BUTTONUP 


MM MIM ERROR 


MM SNDBLST SYNTH 


MM JOY1MOVE 


MM MIM LONGDAT 


MM SNDBLST WAVEIN 


MM JOY1ZMOVE 


MM MIM LONGERROR 


MM SNDBLST WAVEOUT 


MM JOY2BUTTONDOWN 


MM MIM OPEN 


MM WAVE MAPPER 


MM JOY2BUTTONUP 


MM MOM CLOSE 


MM WIM CLOSE 


MM JOY2MOVE 


MM MOM DONE 


MM WIM DATA 


MM JOY2ZMOVE 


MM MOM OPEN 


MM WIM OPEN 


MM MCINOTIFY 


MM MPU401 MIDIIN 


MM WOM CLOSE 


MM MICROSOFT 


MM MPU401 MIDIOUT 


MM WOM DATA 


MM MIDI MAPPER 


MM PC JOYSTICK 


MM WOM OPEN 



Tableau 7.13 : Autres messages 

WM_COALESCE_FIRST 

WM_COALESCE_LAST 

WM_COMMNOTIFY 

WM_COMPAREITEM 

WM_DELETEITEM 

WM_DRAWITEM 

WM_DROPFILES 

WM KEYFIRST 



WM_MDIACTIVATE 

WM_MDICASCADE 

WM_MDICREATE 

WM_MDIDESTROY 

WM_MDIGETACTIVE 

WM_MDIICONARRANGE 

WM_MDIMAXIMIZE 

WM MDINEXT 



_MDIRESTORE 
_MDISETMENU 
_MDITILE 
_MEASUREITEM 
_NEXTDLGCTL 
SYSTEMERROR 



Tableau 7.14 : Messages non documents par Microsoft 



WM_ALTTABACTIVE 

WM_BEGINDRAG 

WM_CONVERTREQUEST 

WM_CONVERTRESULT 

WM_DRAGLOOP 

WM_DRAGMOVE 

WM_DRAGSELECT 

WM_DROPOBJECT 

WM ENTERMENULOOP 



WM_ENTERSIZEMOVE 

WM_EXITMENULOOP 

WM_EXITSIZEMOVE 

WM_FILESYSCHANGE 

WM_GETHOTKEY 

WMJSACTIVEICON 

WM_LBTRACKPOINT 

WM_NEXTMENU 

WM QUERYDROPOBJECT 



_QUERYPARKICON 
_SETHOTKEY 
_SETVISIBLE 
_SIZEWAIT 
_SYNCPAINT 
_SYNCTASK 
_SYSTIMER 
JESTING 
YOMICHAR 
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WinSpector 



WinSpector, accompagne de ses utilitaires, vous permet de realiser un test 
postmortem des UAE ("Unrecoverable Application Errors") et des GPF 
("General Protection Faults"). Lorsqu'une UAE ou une GPF se produit, 
WinSpector ecrit des informations dans un fichier journal. Ce fichier fournit 
des informations concernant la raison de l'erreur. Void le type 
d'informations que vous trouverez dans ce fichier journal : 

■ La pile d'appel qui etait active au moment de l'erreur. 

■ Les noms des fonctions et procedures de la pile d'appel. 

■ Les registres de la CPU. 

■ Un desassemblage des instructions machine pour lesquelles l'erreur a ete 
detectee. 

■ Les informations Windows concernant l'environnement d'execution du 
programme. 



Utilisation de 
WinSpector 



WinSpector 



Avant d'utiliser WinSpector, assurez-vous que le fichier TOOLHELP.DLL 
(de Windows 3.1 ou d'une version ulterieure) figure bien dans un des 
repertoires normalement accessibles. Ce fichier est une bibliotheque DLL 
Windows, fournie avec Borland C++, qui permet aux utilitaires d'acceder 
aux informations systeme de bas niveau. WinSpector utilise 
TOOLHELP.DLL pour detecter si une erreur a ete mise en evidence et pour 
obtenir les informations systeme qu'il ecrit alors dans le fichier journal. 
N'utilisez aucun autre outil que Turbo Debugger en meme temps que 
WinSpector. Vous pouvez lancer WinSpector de trois facons : 

■ L'inclure dans la section "load=" de votre WIN.INI. 

■ L'inclure dans le dossier Ouverture au demarrage de Windows 

■ Cliquer sur son icone depuis Windows. 
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Lorsqu'une erreur UAE ou GPF est detectee, WinSpector cree un rapport 
dans le fichier texte WINSPCTR.LOG pour vous aider a determiner la cause 
de l'erreur. II cree aussi le fichier binaire WINSPCTR.BIN, que l'utilitaire 
DFA traduit en un fichier texte du nom DFA.OUT (voir la description de 
DFA.EXE dans les pages qui suivent). 

Lorsqu'une erreur se produit, WinSpector affiche une boite de dialogue 
contenant un rapport succinct. Vous pouvez cliquer OK pour desactiver 
l'affichage de la boite de dialogue et lire ensuite le fichier journal pour 
prendre connaissance de la cause de l'erreur. Pour modifier les options de 
sortie dans le fichier journal, reportez-vous a la section qui suit. 



Configuration de 
WINSPCTR.LOG 



LogDir=[repertoire] 

LogViewer=[visualiseur] 



CreateNewLog=0 
(ajouter) ou 1 (effacer) 



ShowSystemlnfo=0 
(non) ou 1 (oui) 



II existe deux facons de definir les options de WinSpector qui controlent le 
contenu de WINSPCTR.LOG. 

■ Pour utiliser la boite de dialogue WinSpector Preferences, lancez 
WinSpector, cliquez sur l'icone WinSpector et choisissez Preferences dans 
le menu surgissant. 

■ Pour editer les commandes de WINSPCTR.INI, modifiez-le a l'aide d'un 
editeur de texte puis enregistrez-le et relancez WinSpector 

Les sections qui suivent decrivent chaque option de la boite de dialogue 
Preferences. Les options de WINSPCTR.INI sont listees a gauche. 

Le repertoire dans lequel est situe le fichier WINSPCTR.LOG. Vous pouvez 
specifier le repertoire de votre choix ; par defaut, il s'agit de C:\WINDOWS. 

■ Le visualiseur est le programme que WinSpector utilise pour afficher le 
fichier journal. Entrez le chemin d'acces et le nom du programme de votre 
choix (NOTEPAD.EXE par defaut). Si WinSpector ne trouve pas le 
programme, il affiche le message 

Error: Unable to execute: [programme] 

programme est le nom du fichier de l'editeur. Verifiez que celui-ci est bien 
indique dans le repertoire mentionne. 

■ Les options Append New Reports et Overwrite Previous Reports vous 
permettent de specifier si les nouvelles informations doivent s'ajouter aux 
precedentes ou si elles doivent les effacer. 

■ Cochez System Information pour ajouter la Task List, la Module List et les 
informations concernant les tas USER et GDI au fichier journal. 
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LogToStdAux=0 (non) 
ou 1 (oui) 



PostMortemDump=0 
(non) ou 1 (oui) 



ShowStacklnfo=0 (non) 
ou 1 (oui) 



Showllserlnfo=0 (non) 
ou 1 (oui) 



■ Cochez AUX Summary pour voir, sur le peripherique AUX, une forme 
abregee des informations envoyees dans le fichier journal. II faut pour cela 
qu'un terminal soit connecte a la sortie AUX ou qu'un pilote tel que 
OX.SYS redirige les sorties du peripherique AUX sur un second moniteur. 

■ Cochez l'option PostMortem Dump pour generer le fichier 
WINSPCTR.BIN. Utilisez DFA.EXE pour traduire ce fichier en fichier texte 
lisible. 

■ Cochez Stack Frame Data pour ajouter au fichier journal un listing detaille 
("verbeux") du trace de pile. Pour chaque cadre de pile ne depassant pas 
256 octets, WinSpector effectue un dump hexadecimal en commencant au 
SS:BP du cadre. Si deux cadres de pile comptent plus de 256 octets, 
l'affichage de la memoire n'est pas effectue pour ce cadre. Ces valeurs 
vous permettent de connaitre les parametres passes a la fonction. 

II est en general plus simple de laisser DFA travailler a ^interpretation des 
parametres. Cependant, si les informations de Turbo Debugger ne sont pas 
disponibles, ces donnees vous seront tres utiles. 

■ Cochez User Comments si vous desirez ajouter au fichier journal des 
informations concernant l'operation en cours lors de l'erreur. Si cette 
option est cochee, WinSpector affiche une boite de dialogue juste apres 
l'erreur. Ce que vous saisissez est envoye au fichier journal. 



WINSPCTR.LOG 
References 



Les rapports generes par WinSpector ont plusieurs sections qui vous aident 
a savoir ce qui s'est passe lors de l'exception. La premiere ligne du rapport 
figurant dans WINSPCTR.LOG donne la date de valeur (date et heure) de 
l'exception. Vous obtiendrez par exemple : 

WinSpector failure report - 01/18/1994 11:04:25 

La deuxieme ligne donne les informations suivantes : 

■ Type d'exception survenue. 

■ Nom du module. 

■ Adresse logique. 

■ Adresse physique. 

■ Tache active au moment de l'erreur. 

La deuxieme ligne peut contenir des informations de ce type : 

Exception 13 at USER 002A:0429 (079F:0429) (TASK=BAD) 
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Tableau 8.1 : Types d'exceptions 



Numero Norn Description 

Division par zero Se produit lors d'une interaction DIV ou IDIV si le diviseur est nul. 

1 2 Erreur de pile Cette erreur est generalement provoquee lorsque I'espace de pile s'avere 

insuffisant pour permettre la poursuite de I'operation en cours. 

1 3 Erreur de protection generale Toutes les erreurs de protection ne generant pas d'autre erreur provoquent 

une exception du type 13. 

Les exceptions du type 13 incluent, entre autres, les erreurs suivantes : 

■ Selecteur incorrect charge dans un registre de segment. 

■ Limite de segment depassee. Bien que le selecteur soit valide, la valeur de 
deplacement est superieure a la limite du segment (par exemple, un index 
de tableau ne respectant pas les limites autorisees dans DS, ES, ou dans 
d'autres segments). 

■ L'execution est transferee a un segment non executable, tel qu'un pointeur 
invalide sur une fonction. 

■ Acces aux registres DS, ES, FS ou GS contenant un selecteur nul. (Cette 
erreur peut generer la presence d'un dans le registre de segment du 
fichier journal). 

Le fichier journal mentionne l'adresse physique et l'adresse logique ou 
l'exception s'est produite. Ces deux types d'adresses sont indispensables a la 
bonne execution des programmes Windows pour les raisons suivantes : 

■ Lorsqu'un programme est charge, Windows alloue de I'espace pour 
chaque segment logique et affecte un selecteur unique a chaque segment. 
Le selecteur et son deplacement sont combines a partir d'une adresse 
physique. 

■ Lorsqu'un fichier .EXE Windows est lie, chaque segment est place dans 
une section differente du fichier et une table des segments est alors creee. 

■ Une adresse logique, qui correspond effectivement a la position du 
segment dans la table des segments Windows, se presente comme suit : 
nom du module, segment logique et deplacement. Vous pouvez executer 
TDUMP sur le fichier pour determiner la taille du segment ainsi que 
d'autres informations. Vous pouvez egalement generer un fichier .MAP 
qui contient le meme type d'informations. 

Si le pointeur de pile est trop petit au moment de l'erreur, TOOLHELP.DLL 
permute automatiquement la pile et le message Stack Switched est 
ajoute a la fin de la deuxieme ligne du fichier journal. 
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Section 
Disassembly 



La premiere ligne de la section Disassembly du fichier journal identifie 
l'instruction du langage d'assemblage generant l'exception. Sous cette ligne 
figurent quelques instructions du programme. Ces commandes sont 
mentionnees afin d'etre utilisees comme repere lors de la determination de 
la tache qui a provoque l'exception. 

Dans l'exemple suivant, ES correspond au registre de segment qui contient 
un selecteur et BX correspond au deplacement du segment ; une exception 
de type 13 s'est produite parce que la valeur du deplacement BX est 
superieure a la limite du segment reference par ES : 



079F:0429 CMP 

079F:047D JNE 

079F:042F CMP 

079F:0435 MOV 



BYTE PTR ES: [BX] , FF 

043A 

WORD PTR [BP+406],03 

DI, 0001 



Section Stack Trace 



La premiere ligne de la section Stack Trace (trace de pile) du fichier journal 
identifie la fonction ou la procedure executee au moment de l'exception. Les 
informations fournies incluent les elements suivants : 

■ Numero du cadre. 

■ Nom du module. 

■ Nom de la fonction la plus proche de l'adresse de celle qui a provoque 
l'erreur, suivi d'un nombre indiquant a quelle distance vous vous trouviez 
par rapport a cette fonction (ces informations sont donnees uniquement si 
le fichier .SYM existe). 

■ Adresses physiques et logiques du cadre de pile. 

■ Adresse de retour du programme apres l'appel. 

Lorsque WinSpector donne les noms des fonctions, il recherche dans le 
fichier .SYM le nom symbolique le plus proche precedant l'adresse contenue 
dans la pile d'appel. Certains fichiers .SYM ne contiennent pas les 
informations pour toutes les fonctions. Par consequent, le nom de la 
fonction figurant dans le fichier journal correspond a celui de la fonction la 
plus proche figurant dans le fichier .SYM avec une adresse precedant 
l'adresse de cadre. Si la valeur du champ de deplacement est trop elevee, les 
noms des fonctions peuvent ne pas etre valables. 
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Les informations suivantes concernant l'analyse de la pile donnent les noms 
des fonctions executees au moment ou la tache BAD (notre exemple) a 
genere une exception : 

Stack Trace: 

User <no info> 

CS:IP 002A:0429 (079F:0429) SS:BP 10FF:18CA 

C: \WIN31\SYSTEM\USER.EXE 



3 BAD function5 (unsigned long, unsigned long, unsigned 
long) + 0014 

CS:IP 0001:0184 (1107:0184) SS:BP 10 FF:1952 

C\BIN\BAD.EXE 



Section Registers La section Registers de WINSPCTR.LOG donne la liste des valeurs stockees 
dans les registres du processeur au moment ou l'erreur s'est produite, 
comme le montre l'exemple suivant : 



Reg 


isters : 


AX 


0037 


BX 


0000 


CX 


0008 


DX 


10EE 


SI 


0037 


DI 


0028 



Les restrictions et les droits d'acces sont donnes pour les registres CS, DS, ES 
et SS. 
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Section 
Message Queue : 

Les informations 

L enregistrees dans la 

section File d'attente 

des messages ne 

correspondent pas 

obligatoirement a 

cellesdu dernier 

message que le 

programme a recu. 

(.'utilisation de la 

fonction SendMessage 

permet par exemple a 

Windows de 

court-circuiter la file 

d'attente des 

messages. 



La section Message Queue du fichier journal contient le dernier message 
recu pendant le traitement. Cette section contient aussi les messages figurant 
dans la file d'attente au moment de l'exception. Pour chaque message, 
WinSpector donne les informations suivantes : 

■ Le descripteur de fenetre de la fenetre de destination. 

■ Le numero d'identification du message. 

■ Deux parametres contenant des informations supplementaires concernant 
le message. 

Dans cet exemple, nous voyons un message recu et un message en attente : 

Message Queue: 

Last message received: 

hWnd: 0000 msg: 001 wParam: 0002 lParam: 00000003 
Waiting in queue: 

hWnd: 0000 msg: 0001 wParam : 0002 lParam : 00000003 



Section Tasks Dans la section Tasks du fichier journal, WinSpector donne la liste des 

programmes executes au moment de l'erreur. Cette section contient les 
informations suivantes : 

■ Chemin complet du fichier executable. 

■ Nom du module. 

■ Descripteur du module Windows. 

■ Descripteur de tache. 

■ Valeur du segment de donnees associe a la tache (descripteur d'instance). 

Void certaines des taches executees lorsque notre application, BAD, a 
genere une exception : 

C : \WIN3\SYSTEM\NWPOPUP . EXE 

Module: NWPOPUP hModule: 142F Mask: 141F hlnstance: 13F6 



C : \BIN\WINSPCTR . EXE 

Module: WINSPCTR hModule: 1397 hTask: 1367 hlnstance: 135E 



C:\BIN\BAD.EXE 
Module : BAD 



hMOdule: 1467 hTask: 1127 hlnstance: 10FE 
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Section Modules Dans la section Modules du fichier journal, WinSpector donne la liste des 

modules executes au moment de l'exception. Pour chaque module, les 
informations suivantes sont donnees : 

■ Chemin du fichier executable. 

■ Date de creation du fichier executable. 

■ Taille du fichier. 

■ Nom du module. 

■ Descripteur du module. 

■ Compteur de reference indiquant combien de fois ce module a ete appele. 

Void trois des modules executes lorsque notre application exemple, BAD, a 
genere une exception : 

C:\WIN31\SYSTEM\KRNEL386.EXE Date: 03/02/1992 Size: 116132 

Module: KERNEL hModule: 010F reference count: 21 

C:\WIN31\SYSTEM\SYSTEM.DRV Date: 03/01/1992 Size: 2304 

Module: SYSTEM hModule: 013F reference count: 13 



C:\C\BIN\WINSPCTR.EXE Date: 06/02/1992 Size: 46256 

Module: WINSPCTR hModule: 1397 reference count: 1 



Section des tas 
USER et GDI 



Cette section du fichier journal indique quel etait le pourcentage de 
memoire de tas attribute a USR et GDI (Graphics Device Interface) au 
moment de l'exception. Etant donne que Windows ne dispose que d'un 
espace de tas interne de 64 ko qui doit etre partage entre toutes les 
applications, il s'avere des lors souvent utile d'effectuer le suivi de l'espace 
effectivement utilise. Si vous estimez que USER et GDI utilisent une trop 
grande partie du tas, verifiez que vous avez libere les ressources que vous 
n'utilisez pas. 

Dans notre exemple, cette section se presente ainsi : 



USER 
GDI 



Free 91° 
Free 83° 
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Section Cette section indique le mode et la version de Windows. Elle contient aussi 

System Info j es informations suivantes : 

■ Type de CPU. 

■ Plus grand bloc libre de memoire lineaire contigue disponible. 

■ Espace total de l'adressage lineaire represente sous forme de pages. 

■ Nombre de pages de memoire libre dans l'espace d'adressage lineaire. 

■ Nombre de pages dans le fichier d'echange systeme. 

Par exemple, pour un ordinateur 486 tournant en mode etendu Windows 
3.1, la quantite de memoire disponible est indiquee dans la page-ecran 
suivante : 

System info: Running in enhanced mode under Windows 3.1 

debug version 

CPU : 80486 

Largest free memory block: 3457024 bytes 

Total linear memory space: 19696 K 

Free linear memory space: 18212 K 

Swap file Pages: (OK) 



Traitement des donnees WinSpector 



DFA est un utilitaire qui recupere un fichier WINSPCTR.BIN et les 
informations issues de Turbo Debugger (fichiers .EXE, .DLL ou .TDS) et 
transforme les donnees binaires pour les rendre lisibles. II cree ainsi un 
fichier contenant non seulement les informations d'analyse de pile, comme 
le fichier journal, mais aussi les noms de fonctions, les numeros de ligne et 
les variables locales et globales. 

L'utilitaire DFA effectue un post-traitement des informations de Turbo 
Debugger que WinSpector a regroupees au moment de l'exception. Si vous 
choisissez d'envoyer les informations du rapport a un rapport postmortem, 
WinSpector ecrit un fichier WINSPCTR.BIN au moment de l'erreur. Vous 
pouvez ensuite utiliser DFA pour traduire les donnees binaires du fichier 
WINSPCTR.BIN en informations utilisables qui seront stockees dans le 
fichier DFA.OUT . 
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Sortie de DFA 



Puisque le systeme n'ecrit qu'un seul fichier WINSPCTR.BIN par session 
Windows, assurez-vous que vous executez DFA rapidement. Exemple : si 
vous obtenez trois UAE successivement, WinSpector ecrit alors trois 
rapports dans le fichier journal ; les donnees n'existeront que pour le 
premier rapport. Nous vous recommandons d'executer DFA 
immediatement apres avoir recu le premier message UAE. Vous pourrez 
ensuite renommer le fichier DFA.OUT et supprimer les fichiers 
WINSPCTR.BIN et WFNSPCTR.LOG avant de poursuivre les operations. 

DFA n'ecrit un fichier que s'il trouve des informations de Turbo Debugger 
pour le fichier dans le cadre de pile. Le fichier de sortie DFA (DFA.OUT) 
contient un trace de pile identique a celui contenu dans le fichier journal 
WinSpector. Ce fichier contient de plus les elements suivants : 

■ Noms des fonctions. 

■ Numeros de lignes. 

■ Variables locales et globales. 

■ Segments de donnees et leurs valeurs (y compris le segment de pile). 



Utilisation de DFA 
avec le fichier 
WINSPCTR.LOG 



Lorsque DFA est utilise uniquement avec le fichier WINSPCTR.LOG , il 
donne les informations minimales concernant l'analyse de la pile, telles que 
les adresses. Si les informations de Turbo Debugger (contenues dans un 
fichier .EXE, .DLL ou .TDS ) figurent dans un fichier executable ou dans un 
fichier separe, les noms des fichiers sources ainsi que les numeros de lignes 
sont ajoutes au rapport. 



Utilisation de DFA 

avec 

WINSPCTR.BIN 



Lorsque DFA est utilise avec le fichier WINSPCTR.BIN , il realise les 
traitements suivants : 

■ Ajout des variables de pile au fichier journal (variables locales, parametres 
transmis a la fonction, structures et tableaux). 

■ Mention des types de variables, des valeurs ainsi que des adresses par 
fonction. 
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Format 



De plus, si les informations de Turbo Debugger sont disponibles, DFA 
indique pour chaque cadre de pile : 

■ Dans la premiere section : 

• Le fichier source. 

• Le numero de ligne. 

• Les variables locales. 

• Les parametres. 

■ Dans la deuxieme section : 

• Le nom du module pour la tache defaillante. 

• Le nom des fichiers. 

• Les segments logiques. 

• Les selecteurs de segments. 

• Le type des segments : donnees ou code . 

■ Dans la troisieme section : 

• Les variables globales. 

• Les variables statiques. 

• Les valeurs des variables au moment de l'erreur. 

DFA [option] WINSPCTR.LOG [WINSPCTR.BIN] 

Si le fichier WINSPCTR.LOG (fichier obligatoire) existe, vous n'obtenez que 
les informations suivantes : nom du fichier source et numeros de ligne. Si 
WINSPCTR.BIN (fichier facultatif ) existe, vous obtenez les informations 
complementaires concernant les variables. 



Tableau 8.2 
Options de DFA 



Option Resultat 

IOfichier_sortie Renomme le fichier de sortie (DFA.OUT est le nom implicite) 

/D Demande a DFA d'ecrire une liste hexadecimale des segments de donnees 

sauvegardees. 
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Autres outils de WinSpector 



Vous pouvez utiliser les trois utilitaires ci-dessous pour enrichir encore les 
informations que WinSpector fournit pour une exception : 

■ EXEMAP cree un fichier .MAP a partir d'un fichier .EXE Windows. Le 
fichier .MAP est requis pour la creation du fichier .SYM, qui ameliore le 
compte-rendu d'erreurs pour l'EXE original. 

■ TMAPSYM, utilise avec EXEMAP.EXE, cree un fichier .SYM depuis un 
fichier .MAP. 

■ BUILDSYM utilise EXEMAP.EXE et TMAPSYM.EXE pour creer un fichier 
.SYM depuis un fichier .EXE Windows. 



Utilisation de 
EXEMAP.EXE 



Utilisation de 
TMAPSYM 



EXEMAP cree des fichiers .MAP des executables Windows. Un fichier .MAP 
peut etre utilise pour creer un fichier .SYM . WinSpector peut alors utiliser 
ce fichier pour enrichir le rapport d'erreurs. Si vous utilisez des DLL ou 
d'autres programmes dont vous ne disposez pas du code source, ces 
informations peuvent s'averer particulierement utiles. 

Pour creer un fichier .MAP depuis un fichier .EXE, tapez la commande 
EXEMAP fichier.EXE nouveaunom. MAP. Si le second fichier est omis, le 
nom du fichier .EXE est conserve pour le fichier .MAP. 

Bien que le fichier .MAP resultant ne soit pas aussi complet que celui qui est 
genere lors de la phase de lien du processus de compilation, il contient les 
adresses des fonctions publiques exportees. 

TMAPSYM cree un fichier .SYM a partir d'un fichier .MAP existant (lequel 
est cree a l'aide du compilateur ou de l'utilitaire EXEMAP). Le fichier .SYM 
resultant permet a WinSpector d'utiliser les fonctions publiques, les noms 
de variables ainsi que les fonctions figurant dans la table d'entree de 
l'executable. Toutefois, les informations concernant les constantes et les 
numeros des lignes ne sont pas incluses dans ce fichier. 

Pour creer un fichier .SYM a partir d'un fichier .MAP, tapez TMAPSYM 
fichier. MAP (l'extension .MAP est obligatoire). 
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Utilisation de BUILDSYM cree des fichiers .SYM a partir de fichiers .EXE. La sortie 

BUILDSYM generee est la meme qu'en utilisant a la fois EXEMAP et TMAPSYM, 

puisqu'il charge ces deux utilitaires, mais il supprime le fichier .MAP de 
votre repertoire. BUILDSYM reconnait les caracteres jokers ? et *, ce qui 
permet de traiter tout un repertoire en une seule commande. 

Pour executer BUILDSYM, les deux utilitaires EXEMAP et TMAPSYM 
doivent etre accessibles. BUILDSYM stocke les fichiers .SYM resultants dans 
le repertoire actif . Pour que WinSpector puisse trouver un fichier .SYM , 
celui-ci doit se trouver dans le meme repertoire que celui de l'executable qui 
cause l'erreur. 

BUILDSYM execute les taches suivantes : 

■ II verifie que les fichiers sont effectivement des fichiers Windows. Dans le 
cas contraire, il ne cree aucun fichier .MAP ou .SYM pour ces fichiers. 

■ II lance EXEMAP pour creer les fichiers .MAP . 

■ II s'assure que les fichiers .MAP ont bien ete crees. 

■ II lance TMAPSYM et transmet les noms des nouveaux fichiers .MAP afin 
de creer les fichiers .SYM . 

■ II supprime les fichiers .MAP puisqu'ils ne sont plus d'aucune utilite. 

Pour creer un fichier .SYM a partir d'un .EXE, tapez BUILDSYM 
fichier.EXE. 

Vous pouvez utiliser les caracteres jokers habituels dans la par tie fichier de la 
commande. Par exemple, tapez BUILSYM * . EXE pour creer des fichiers 
.SYM pour tous les fichiers .EXE du repertoire actif. 
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Utilisation de I'editeur de 
liens TLINK 



L'annexe Adonnela 

liste des messages de 

I'editeur de liens 

generees par TLINK et 

par I'editeur de liens 

integre de I'EDI. 



TLINK et TLINK32 sont des outils de ligne de commande qui associent des 
modules objets (fichiers .OBJ) et des modules bibliotheques (fichiers .LIB) 
pour produire des fichiers executables. L'EDI utilise des versions integrees 
d'editeurs de liens. Du fait que le compilateur appelle automatiquement 
I'editeur de liens, vous n'avez pas besoin d'utiliser TLINK saufsi vous 
supprimez l'etape d'edition de liens de la compilation (reportez-vous a 
l'option -c du compilateur). Sauf indication contraire, les instructions et les 
options de TLINK s'appliquent egalement a TLINK32. 



Notions de base sur TLINK 



Les options de TLINK 
et TLINK32 sont 

sensibles a la 

difference 

majuscules/minuscules. 



TLINK utilise un fichier de configuration intitule TLINK.CFG, un fichier de 
recherche (facultatif ), et des options de lignes de commandes pour lier des 
modules objets, des bibliotheques et des ressources en vue de creer un 
fichier executable (.EXE ou .DLL). L'editeur de liens de l'EDI utilise les 
options indiquees dans la boite de dialogue Project Options de la section 
Linker. La syntaxe de TLINK est la suivante : 

TLINK [@ f_rech] [options] f_demarr objetss , nom_exe, 
[f_map] , [biblios] bib_runtime [import] , [f_def], [f_res] 

ou 

■ options sont des options de TLINK qui command ent le fonctionnement 
de TLINK. Par exemple des options permettent d'indiquer si on veut 
produire un fichier .EXE ou DLL. Les options de TLINK doivent etre 
precedees soit d'unebarre oblique (/), soit d'un trait d'union (-). Pour 
desactiver une option par defaut, mettez un trait d'union a la suite de 
l'option (par exemple -P-). Les options TLINK sont enumerees dans le 
tableau 9.3. 
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Reportez-vous aux 

tableaux 9.1 et 9.2 pour 

savoir quel module 

utiliser. 



f_demarr est un module d'initialisation Borland pour fichiers 
executables ou fichiers DLL, qui s'occupe du classement des divers 
segments du programme. Le module d'initialisation doit venir en premier 
dans la liste du fichier objet. S'il n'est pas en premiere position, les 
segments du programme risquent de ne pas etre places au bon endroit 
dans la memoire et de provoquer des bugs desagreables. Si le module 
d'initialisation n'est pas correctement enchaine, vous risquez d'avoir une 
longue liste de messages d'erreur vous indiquant que certains 
identificateurs n'ont pas ete traduits ou qu'aucune pile n'a ete creee. 

objets sont les fichiers .OBJ que vous voulez enchainer. Indiquez le 
chemin d'acces si ces fichiers ne se trouvent pas dans le repertoire en 
cours. 

nom_exe est le nom que vous voulez dormer au fichier executable (.EXE 
or.DLL). Si vous ne precisez pas le nom du fichier executable, TLINK lui 
donne un nom en ajoutant .EXE ou .DLL au nom du premier fichier objet 
de la liste. Veillez a donner un nom explicite au fichier executable sur la 
ligne de commande de TLINK. Sinon, le nom de votre programme sera du 
type C02.EXE, qui ne correspondra probablement pas a ce que vous 
souhaitez. 

f_map (facultatif ) est le nom que vous voulez donner au fichier de 
mappage. Si vous n'indiquez pas de nom, le nom du fichier est celui 
d' exefile(mais avec l'extension .MAP). 

bibl ios (facultatif) sont les fichiers bibliotheques que vous voulez 
inclure au moment d'editer les liens. Si ces fichiers ne sont pas dans le 
repertoire ou le chemin de recherche en cours (voir l'option /L), vous 
devez indiquer leur chemin d'acces. 

bib_runtime est la bibliotheque d'execution Borland. Si aucune 
bibliotheque n'est incluse, aucune ne sera enchainee. 

import est la bibliotheque d'importation Windows qui permet d'acceder 
aux fonctions API de Microsoft Windows. 

f_def est le fichier de definition des modules (.DEF) des fichiers 
executables Windows. Si vous n'indiquez pas de fichier .DEF, TLINK cree 
une application basee sur des parametres par defaut. 

f res sont une liste de fichiers .RES a enchainer au fichier executable. 
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TLINK utilise par defaut ou ajoute les extensions suivantes aux noms de 
fichiers qui n'en ont pas : 

■ .OBJ pour les fichiers objets 

■ .EXE pour les fichiers executables 

■ .DLL pour les bibliotheques a liaisons dynamiques 

■ .MAP pour les fichiers de mappage 

■ .LIB pour les fichiers bibliotheques 

■ .DEF pour les fichiers de definition de modules 

■ .RES pour les fichiers de ressources 



TLINK.CFG 

L'EDI utilise les 

options d'edition de 

liens indiquees dans 

les options du projet 

et les feuillesde style. 

Reportez-vous au 

chapitre 2 pour plus 

d'informations sur les 

valeursadonneraux 

options du projet. 



TLINK utilise un fichier de configuration intitule TLINK.CFG (ou 
TLINK32.CFG) pour les options que vous devriez normalement taper sur la 
ligne de commande (notez que TLINK.CFG ne peut contenir que des 
options, pas de noms de fichiers). Les fichiers de configuration vous 
permettent de sauvegarder les options que vous utilisez souvent pour vous 
eviter de les retaper a chaque fois. 

TLINK cherche TLINK.CFG dans le repertoire en cours, puis dans le 
repertoire a partir duquel TLINK a ete charge. 

Le fichier TLINK.CFG suivant dit a TLINK de chercher les bibliotheques 
d'abord dans le repertoire C:\BC4\LIB puis dans C:\WINAPPS\LIB, pour 
inclure des informations de debogage dans les fichiers executables qu'il cree, 
pour creer un mappe detaille des segments et pour produire un fichier 
Windows executable (.EXE et non .DLL). 



TLINK 

/Lc: \bc4\lib; c : \winapps\lib 

/v /s 

/Twe 



TLINK32 

/Lc : \bc4\lib; c : \winapps\lib 

/v /s 

/Tpe 
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Fichiers de 
recherche 

Les compilateurs en 

ligne de commande 

utilisent egalement 

des fichiers de 

recherche. 

Reportez-vous a la 

section "Fichiers de 

recherche" du 

chapitre 3 pour plus 

d'informations. 



Les fichiers de recherche sont des fichiers ASCII qui contiennent les options 
et noms de fichiers destines a TLINK.EXE (et TLINK32.EXE) que vous 
devriez normalement taper sur la ligne de commande. Les fichiers de 
recherche vous permettent d'avoir une ligne de commande plus longue que 
ne le permettent la plupart des systemes d'exploitation. lis peuvent contenir 
les memes informations que les fichiers de configuration (options de lignes 
de commande), mais peuvent en plus contenir des noms de fichiers. 

Contrairement aux lignes de commande, les fichiers de recherche peuvent 
contenir plusieurs lignes. Pour avoir plusieurs lignes dans votre fichier de 
recherche, terminez chaque ligne par un caractere (+). Notez que si une ligne 
se termine par une option activee par le signe plus (par exemple /v+), le + 
n'est pas considere comme un caractere de continuation de ligne (pour 
prolonger la ligne, utilisez /v++). 

Si, a l'interieur d'un fichier de recherche, vous separez des elements de la 
ligne de commande (par exemple des fichiers .OBJ et des fichiers .LIB) par 
des lignes, vous ne devez pas taper la virgule qui les separe normalement 
quand ils sont sur une meme ligne de commande. Par exemple : 

/c cOws+ 

monprog, raonexe 

monmap 

mabib cws 

Cette syntaxe omet la virgule que vous devriez taper si les informations 
etaient toutes sur la meme ligne, comme ceci : 

TLINK /c cOws monprog, monexe, monmap, mabib cws 

Pour utiliser des fichiers de recherche, 

1. Tapez les options de lignes de commande et les noms des fichiers dans 
un fichier texte ASCII que vous sauvegardez. 

2. Tapez TLINK @@ [chemin] F_RECH .RSP, ou F_RECH.RSP est le nom 
de votre fichier de recherche. 

Vous pouvez indiquer plusieurs fichiers de recherche, comme ceci : 

tlink /c @@listob js, monexe, monmap, @@listlibs 

Si vous utilisez un fichier de recherche en plus d'options de lignes de 
commande, ces dernieres se substitueront a toute option du fichier de 
recherche. Par exemple, si vous inserez un -V dans un fichier de recherche 
mais utilisez -V- sur la ligne de commande, TLINK utilise l'option de ligne 
de commande -V-. 
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Utilisation de 

TLINKavec 

BCC.EXE 

BCC lance toujours 

TLINKavec l'option/c 

(difference 

majuscules/minuscules). 



Vous pouvez transmettre des options et des fichiers a TLINK par 
l'intermediaires des compilateurs en ligne de commande (BCC.EXE et 
BCC32.EXE), en tapant les noms de fichiers sur la ligne de commande, sans 
oublier leur extension .OBJ et .LIB. Par exemple, 

BCC princip.obj subl.obj mabib.lib 

effectue l'edition de liens PRINCIP.OBJ, SUBl.OBJ et MABIB.LIB, puis 
produit le fichier executable PRINCIP.EXE. 

BCC lance TLINK avec les fichiers COWS.OBJ, CWS.LIB et IMPORT.LIB 
(module d'initialisation, bibliotheque d'execution et bibliotheque 
d'importation Windows). BCC32 lance TLINK32 avec les fichiers 
C0W32.OBJ, CW32.LIB et EVIPORT32.LIB par defaut. 



Edition de liens 
pour les 
bibliotheques 



Vous devez obligatoirement enchainer la bibliotheque d'execution Borland 
C++ qui contient les fonctions de bibliotheque C/C++ standard pour le 
type d'application que vous etes en train d'enchainer. Vous devez aussi 
inserer la bibliotheque d'importation qui convient (IMPORT.LIB pour les 
applications Windows 16 bits, IMPORT32.LIB pour les applications 
machine, ou IMPRTW32.LIB pour les applications Windows 32 bits). 

Le tableau 9.1 decrit les bibliotheques Windows 3.x 16 bits et les fichiers 
.OBJ fournis par Borland. Reportez-vous au Guide de reference pour avoir la 
liste complete des bibliotheques Windows, et au Guide de reference DOS pour 
la liste complete des bibliotheques et fichiers de demarrage DOS. 



Tableau 9.1 

Bibliotheques 16 bits et 

fichiers de demarrage 

Borland 



Bibliotheques et 
fichiers .OBJ 



Description 



Cn.LIB 
CW/i.UB 

CRTLDLLUB 

IMPORT.LIB 
COn.OBJ 



Bibliotheque d'execution pour applications DOS ou n est S, C, M, L 
ou H pour designer le modele de memoire : SMALL, COMPACT, 
MEDIUM, LARGE ou HUGE. 

Bibliotheque d'execution pour applications Windows 3.x, ou n est S, 
C, M ou L pour designer le modele de memoire : SMALL, 
COMPACT, MEDIUM ou LARGE. 

Bibliotheque d'execution pour applications Windows 3.x a enchainer 
comme fichier .DLL. 

Bibliotheque d'importation pour fonctions API de Windows 3.x. 

Code de demarrage pour applications .EXE DOS ou n est T, S, C, 
M, L ou H pour designer le modele de memoire : TINY, SMALL, 
COMPACT, MEDIUM, LARGE ou HUGE. 
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Tableau 9.1 
Bibliotheques 16 bits et 

fichiers de demarrage 
Borland 



Bibliotheques et 
fichiers .OBJ 



Description 



COWn.OBJ 

CODn.OBJ 

MATHWS.LIB 

MATHWC.UB 
MATHWM.LIB 
MATHWL.LIB 



Code de demarrage pour applications Windows 3.xou n est S, M, C 
ou L pour designer le modele de memoire : SMALL, MEDIUM, 
COMPACT ou LARGE. 

Code de demarrage pour modules .DDL Windows 3.xou n est S, M 
ou L pour designer le modele de memoire : SMALL, MEDIUM ou 
LARGE. 

Si votre programme utilise des virgules flottantes, vous devez inclure 
une bibliotheque mathematique. MATHWS.LIB est destinee aux 
modeles SMALL et TINY. 

Bibliotheque mathematique pour modeles COMPACT. 

Bibliotheque mathematique pour modeles MEDIUM. 

Bibliotheque mathematique pour modeles LARGE. 



Le tableau 9.2 decrit les bibliotheques et fichiers .OBJ 32 bits fournis par 
Borland ; ils sont utilises par TLINK32. Reportez-vous au Guide de reference 
pour avoir la liste complete des bibliotheques. 



Tableau 9.2 

Bibliotheques et 

fichiers de 

demarrage Borland 

32 bits 



Bibliotheques et fichiers Description 
.OBJ 



CW32.LIB 
IMPORT32.LIB 

C0X32.OBJ 
C0W32.OBJ 
C0D32.OBJ 



Bibliotheque d'execution pour applications Win32. 

Bibliotheque d'importation pour applications machine et applications 
Windows 32 bits. 

Code de demarrage pour applications machine. 

Code de demarrage pour applications Win32. 

Code de demarrage pour modules DLL 32 bits. 
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Options deTLINK 



Sauf indication contraire, les options fonctionnent a la fois avec TLINK et 
avec TLINK32. Elles sont sensibles a la difference majuscules/minuscules et 
doivent etre precedees d'une barre oblique (/) ou d'un trait d'union (-). 
Pour desactiver une option par defaut, mettez un trait d'union a la suite de 
l'option sur la ligne de commande (par exemple, -P- ou /P-). Vous pouvez 
placer des options a n'importe quel endroit de la ligne de commande. II 
n'est pas necessaire de separer les options par des espaces (/m/f/c est la 
meme chose que /m /f It), mais par contre un espace est obligatoire pour 
separer options et fichiers. 

Le tableau 9.3 enumere les options de ligne de commande de TLINK et les 
options EDI correspondantes (notez que toutes les options n'ont pas un 
equivalent dans l'EDI). Les options de ligne de commande par defaut sont 
signalees par le symbole suivant : ■. Vous trouverez a la suite du tableau des 
explications plus detaillees sur ces options, notamment le nom des 
options EDI. 



Tableau 9.3 : Options TLINK 

Par defaut Option Option de Pediteur de liens EDI 



Pour 



Description 



/3 



Linker|16-bits Linker[Enable 32-bit processing 16 bits 



lax 

Target Attributes|Target Model 

<neant> 
/A:dd 1 6-bit|Segment Alignment 

IB:xxxxxx 32-bit Linker|lmage based address 

/c General|Case-sensitive link 

/C General|Case-sensitive exports, imports 



/d 



Warnings|Warn duplicate symbol in .LIB 



Accepte et enchaine un code 32 bits 
produit par TASM ou un assembleur 
compatible. 
32 bits Indique le type d'application, ou 

/aa cibie des applications Windows 

/ap cible des applications machine. 

1 6/32 bits Indique I'alignement des pages a 

rinterieurdufichier.EXE. 
32 bits Indique I'adresse de base des images 

(en hexadecimal). 
1 6/32 bits Considere les caracteres comme 

significatifs dans les symboles. 
1 6 bits Considere les caracteres comme 

significatifs dans les sections 

EXPORTS et IMPORTS du fichier de 

definition des modules. 
1 6 bits Vous avertit en cas de symboles en 

double dans des bibliotheques. 
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Tableau 9.3 : Options TLINK (suite) 



Par defaut Option 


Option de I'editeur de liens EDI 


Pour 


Description 


/c 


General Case-sensitive link 


16/32 bits 


Considere les caracteres comme 
significatifs dans les symboles. 


/C 


General Case-sensitive exports, imports 


16 bits 


Considere les caracteres comme 
significatifs dans les sections 
EXPORTS et IMPORTS du fichier de 
definition des modules. 


/d 


Warnings Warn duplicate symbol in .LIB 


16 bits 


Vous avertit en cas de symboles en 
double dans des bibliotheques. 


/E 


16-bit Linker Process extended dictionaries 


16 bits 


Permet le traitement de dictionnaires 
etendus dans les bibliotheques. 


lEnn 


32-bit Linker Maximum linker errors 


32 bits 


Indique le nombre maximum d'erreurs 
avant interruption. 


■ le 


1 6-bit Process extended dictionaries (uncheck) 


16 bits 


Ignore les dictionnnaires etendus 
dans les bibliotheques.C'est le 
contraire de I'option IE . 


/f 


1 6-bit Linker Inhibit optimizing far to near 


16 bits 


Invalide I'optimisation des appels far a 
des donnees near. 


/Gx 




16/32 bits 


"Super" options ou xest n, r, ou m. 


/Gn 


16-bit Linker Discard nonresident name table 


16 bits 


Ne tient pas compte des tables de 
noms non-residents. 


/Gr 


1 6-bit Transfer resident to nonresident table 


16 bits 


Transfere les noms residents dans 
une table de noms non-residents. 


/Gm 


Map File Print mangled names in map file 


16/32 bits 


Met les noms non significatifs dans un 
fichier mappe. 


/i 


16-bit Linker Initialize segments 


16 bits 


Initialise tous les segments. 


/I 


Map File Include source line numbers 


16 bits 


Insere des numero de ligne source (L 
minuscule). 


/L 


Directories Library (pas dans Linker de I'EDI) 


16/32 bits 


Indique les chemins d'acces des 
bibliotheques. 


/m 


Map File|Public 


16/32 bits 


Cree un fichier de mappe avec acces 
publics. 


/n 


General Default Libraries 


16 bits 


Ne pas utiliser les bibliotheques par 
defaut. 


/o 


Overlay module (Boite de dialogue des attributs 


16 bits 


Modules ou bibliotheques de 




de noeuds) 




recouvrement. 


■ /P 


General Pack code segments 


16 bits 


Stockage de segments de codes. 


/Rk 


Resource Pack fast load area (not under Linker) 


16 bits 


Envoi des options a RLINK.EXE. 


/Rv 


<neant> 


32 bits 


Edition de liens avec des ressources 
verbeuses. 
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Tableau 9.3 : Options TLINK (suite) 



Par defaut 



Option 


Option de I'editeur de liens EDI 


/Rexxxx 


<neant> 


IS:xxxxxx 


32-bit Linker|Stack size 


Is 


Map File|Detailed 


/t 


<neant> 


/Tdx 


16 bits 




<neant> 




TargetExpert Platform 


/Tpx 


TargetExpert Platform 



/Twx TargetExpert Target Type 

/v General|lnclude debug information 

Ivixxx Warnings (voir tableau 9.4). 



Ix 
/ye 

/yx 



@ 



Map File|Off 
<neant> 

<neant> 



Pour Description 

32 bits Renomme le fichier executable : xxxx. 

32 bits Indique la taille de la pile (en 

hexadecimal). 
1 6 bits Cree un mappe detaille des segments. 

1 6 bits Cree un fichier .COM DOS de modele 
TINY. 
Indique ['application cible ou 

/Tdc signifie creer un fichier .COM 
DOS. 

/Tde signifie creer un fichier .EXE 
DOS. 
32 bits Indique une application cible, oil 

/Tpe signifie creer un fichier .EXE 
32 bits. 

/Tpd signifie creer une DLL 32 bits. 
1 6 bits Indique une application Windows 3.x, 
ou 

/Twe cree un fichier .EXE Windows. 
/Twd cree une DLL Windows. 
1 6/32 bits Inclut des informations de debogage 

symboliques completes. 
32 bits Active ou desactive les mises en 

garde (voir tableau 9.4). 
1 6/32 bits Ne cree pas de fichier de mappe. 

1 6 bits Utilise la memoire paginee pour les 

permutations. 
1 6 bits Configure I'utilisation par TLINK de la 

permutation avec la memoire paginee. 



/3 vous permet d'enchainer des modules objets DOS 32 bits produits par 
TASM ou un assembleur compatible. Cette option augmente la quantite de 
memoire requise pour TLINK et ralentit la procedure d'edition de liens. 

/a vous permet d'indiquer le type d'impage EXE : 

■ /aa cible des applications Windows. 

■ /ap cible des applications machine qui peuvent etre executees dans une 
fenetre. 
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/A:dd indique I'alignement des pages pour les codes et donnees du fichier 
executable dd doit etre une puissance decimale de 2. Par exemple, si vous 
indiquez un alignement de /A:12 , les sections de l'image sont enregistrees 
sur les limites de 4096 octets. Le systeme d'exploitation se base sur cette 
valeur pour chercher des pages a charger. La valeur par defaut est /A:9, ce 
qui signifie que les sections sont alignees sur les limites de 512 octets a 
l'interieur du fichier executable. 

IB-.xxxxxx indique une adresse de base pour les images d'une application 
32 | donnee. Si cette option est utilisee, les relocations internes sont supprimees 
de l'image et I'adresse de chargement du premier objet demande prend le 
numero hexadecimal donne avec I'option. Tous les objets qui suivent sont 
alignes sur les limites d'adresse lineaires de 64 ko. Cette option reduit la 
place occupee par les applications sur le disque et ameliore a la fois le 
temps de chargement et les performances d'execution, dans la mesure ou le 
systeme d'exploitation n'a plus besoin de proceder a des relocations 
internes. Du fait que NT charge toutes les images .EXE a 64 ko, nous vous 
conseillons d'enchainer tous les fichiers .EXE a I'aide de /B:0x10000. 

/c rend les majuscules et minuscules significatives dans les symboles publics 
et externes. 

/C rendles majuscules et minuscules significatives dans les sections 
]f] EXPORTS et IMPORTS des fichiers de definition de modules. 





/d vous avertit si un symbole apparait dans plusieurs fichiers bibliotheques. 
I g | Si le symbole doit etre insere dans le programme, TLINK utilise le symbole 
du premier fichier contenant le symbole indique sur la ligne de commande 
(ou dans un fichier de recherche). Cette option vous avertit egalement si des 
symboles apparaissent a la fois dans un fichier .OBJ et dans un fichier .LIB 
(TLINK utilise le premier fichier enchaine et ignore les autres). 
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lEnn precise le nombre maximum d'erreurs indique par l'editeur de liens 
avant interruption. /EO (par defaut) indique un nombre infini d'erreurs 
(c'est-a-dire autant que possible). 

/E traite les dictionnaires etendus. Les fichiers bibliotheques de Borland C++ 
contiennent un dictionnaire etendu avec des informations permettant a 
TLINK d'utiliser moins de memoire et d'editer plus rapidement des liens 
avec ces bibliotheques. Vous pouvez ajouter le dictionnaire etendu dans 
d'autres fichiers bibliotheques a l'aide de l'option /E de TLIB (reportez-vous 
a la section sur TLIB dans le chapitre 11). Evitez d'utiliser /E avec des 
programmes ayant des liens avec des bibliotheques creees sans dictionnaire 
etendu (bibliotheques de tiers fournies sans le code source, par exemple). 
Pour pouvoir utiliser les dictionnaires etendus, il faut que toutes les 
bibliotheques liees aient un dictionnaire etendu. 

/e ne tient pas compte des dictionnaires etendus. C'est le contraire de 
l'option /E, et c'est la valeur par defaut. 






/f invalide l'optimisation des appels far a des donnees near. 

/Gx sont des options ou x peut etre 

n = Ignorer la table des noms non-residents. 

r = Transferer les noms residents dans une table de non-residents. 

m = (TLINK32) Met les noms non significatifs dans le fichier de mappe ; 
peut vous aider a savoir comment les noms sont modifies. 

I\ envoie les segments de fin non initialises dans le fichier executable, meme 
si ces segments ne contiennent pas d'enregistrement. 

/I cree une section dans le fichier .MAP pour les numeros de ligne du code 
source. Les fichiers .OBJ enchaines doivent etre compiles avec les 
informations de debogage a l'aide de -y ou -V. Si vous utilisez /x pour 
supprimer la creation du fichier de mappe, l'option /I (L minuscule) est sans 
effet. 
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/L vous permet d'afficher la liste des repertoires que TLINK explorera si 
vous ne tapez pas le nom de chemin explicite d'une bibliotheque ou du 
module d'initialisation C ou C++. TLINK explore en premier le repertoire en 
cours (dans lequel vous avez tape TLINK). Par exemple, 

TLINK /Lc : \BC4 \lib; c : \mesbibs splash logo, , , utils .\logolib 

explore d'abord le repertoire en cours pour trouver UTILS.LIB, explore 
ensuite C:\BC4\LIB, puis C:\MESBIBS. Dans la mesure ou LOGOLIB 
designe explicitement le nom du repertoire en cours, TLINK n'explore pas 
les bibliotheques indiquees avec l'option /L pour trouver LOGOLIB. LIB. 

/m cree un mappe plus complet que celui normalement realise par TLINK, 
en ajoutant dans le mappe une liste triee de symboles publics. Ce type de 
fichier de mappe est utile pour le debogage. De nombreux debogeurs 
peuvent utiliser la liste des symboles publics, ce qui vous permet de faire 
reference a des adresses symboliques quand vous deboguez. Si vous ne 
definissez aucune option du fichier de mappe (/m, /s,ou /x), c'est l'option 
Map File I Segments qui est utilisee. Voir egalement /s. 

/M cree un mappe avec noms publics non significatifs. 



/n ignore les bibliotheques par defaut indiquees par certains compilateurs. 
Utilisez cette option pour enchainer des modules qui sont ecrits dans un 
autre langage. 

/o active le recouvrement pour le code dans tous les modules ou 
bibliotheques qui suivent l'option sur la ligne de commande (cette option ne 
fonctionne que pour les applications DOS). Utilisez /o- sur la ligne de 
commande pour desactiver cette fonction. Si vous indiquez un nom de 
classe a la suite de cette option, tous les segments de cette classe seront 
recouverts (vous pouvez le faire pour plusieurs classes). Si vous n'indiquez 
pas de nom a la suite de l'option, tous les segments des classes se terminant 
par CODE seront recouverts. Cette option utilise le numero d'interruption 
de recouvrement par defaut 3FH. Pour indiquer un autre numero 
d'interruption, utilisez /o#xx, ou xx est un nombre hexadecimal a deux 
chiffres. 
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IP reunit autant de segments de code qu'il est possible dans un segment 
physique, dans la limite des possibilites de stockage de segments de code 
(jamais au-dela). TLINK cree un nouveau segment si necessaire. La limite de 
stockage par defaut de segments de code est de 8 192 octets (8 ko). Pour la 
modifier, utilisez /F=n ou n indique une nombre d'octets entre 1 et 65 536. 
Vous prefererez sans doute que cette limite soit un multiple de 4 ko en 
mode 386 renforce, en raison de la granularite des unites de memoire a acces 
direct du systeme. 

Bien que la taille optimale des segments en mode ameliore 386 soit de 4 ko, 
la taille de stockage par defaut est de 8 ko du fait que les segments de code 
types sont de 4 a 8 ko et qu'il est plus facile de stocker 8 ko. 

Du fait que chaque segment est supervise par un systeme, le stockage des 
segments de code ameliore en principe les performances. IP- desactive le 
stockage des segments de code (utile si vous l'avez active dans le fichier de 
configuration et voulez le desactiver pour un lien donne). 

Is cree un fichier de mappe avec les memes fonctions que l'option /m , mais 



1 g ajoute un mappe de segment detaille. Si vous ne definissez pas la valeur des 



options (/m, Is, ou /x), c'est l'option MapFile I Segments qui est utilisee. 
Pour chaque segment de chaque module, ce fichier de mappe inclut 
l'adresse, la longueur en octets, la classe, le nom du segment, le groupe, le 
module et les informations ACBP. Si le meme segment apparait dans 
plusieurs modules, chaque module fait l'objet d'une ligne separee. A 
l'exception du champ ACBP, les informations du mappe detaille des 
segments sont tres explicites. 

Le champ ACBP code les attributs A (alignement), C (combinaison) et B 
(big) en un groupe de champs de quatre bits, tel que defini par Intel. TLINK 
n' utilise que trois de ces champs, les champs A, C et B. La valeur d'ACBP 
dans le mappe est imprimee en hexadecimal. Les valeurs de champ qui 
suivent doivent etre reunies par des OR pour atteindre la valeur ACBP 
imprimee. 
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Champ Valeur Description 



ChampA(alignement) 


00 


Segment absolu. 




20 


Segment aligne sur les octets. 




40 


Segment aligne sur les mots. 




60 


Segment aligne sur les paragraphes. 




80 


Segment aligne sur les pages. 




A0 


Portion de memoire absolue sans nom 


Champ C (combinaison) 


00 


Ne peut etre combine. 




08 


Segment de combinaison public. 


Champ B (big) 


00 


Segment de moins de 64 ko. 




02 


Segment de 64 ko exactement. 



Avec l'option /s les symboles publics sans reference sont etiquetes " inactif s". 
Un symbole inactif est un symbole de module publiquement defini auquel il 
n'a pas ete fait reference par un enregistrement EXTDEF d'un autre module 
inclus dans le lien. Par exemple, ce fragment de la section de symboles 
publics d'un fichier de mappe montre qu'il n'est pas fait reference aux 
symboles Symboll et Symbol3 par l'image qui leur est liee : 

0002:00000874 Inactif Symboll 

0002:00000CE4 Symboll 

0002:000000E7 Inactif SymboB 

| | IS:xxxxxx definit la taille en hexadecimal de la pile de l'application ou 
M 32 xxxxxx est une chaine hexadecimale. Le fait d'indiquer la taille de la pile 

' avec /S annule l'effet de tout reglage de la taille de la pile dans un fichier de 
definition de modules. 

/t cree un fichier .COM DOS de modele TINY (cette option fonctionne 
comme /Tdc, a cette exception pres que vous pouvez utiliser /t avec 
BCC.EXE). Les fichiers .COM DOS ne peuvent depasser 64 ko, ont des 
relocations liees aux segments ou definissent un segment de pile. lis doivent 
avoir une adresse de depart de 0:100H. Si vous voulez changer l'extension 
des fichiers (pour .BIN, par exemple), l'adresse de depart peut etre soit 0:0, 
soit 0:100H. L'editeur de liens ne peut generer d'informations de debogage 
pour les fichiers .COM ; il vous faudra done les deboguer comme des 
fichiers .EXE, puis les recompiler et enchainer comme des fichiers .COM. 

/Tdxproduit un fichier .EXE DOS (/Tde) ou un fichier .COM DOS (/Tdc). 
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/Tpxproduit un fichier .EXE (/Tpe) ou .DLL (/Tpd) en mode protege. 



/Twxproduit un fichier Windows .EXE (/Twe) ou .DLL (/Twd). Cette option 
n'est pas necessaire si vous incluez un fichier de definition de modules avec 
une instruction EXETYPE Windows ; TLINK cree en effet une 
application(.EXE) si le fichier de definition de modules contient une 
instruction NAME, ou une DLL si le fichier de definition de modules 
contient une instruction LIBRARY. 

/v insere des informations de debogage dans le fichier executable. Si cette 
option est trouvee quelque part sur la ligne de commande, les informations 
de debogage sont inserees dans le fichier executable pour tous les modules 
objets qui contiennent des informations de debogage. Vous pouvez utiliser 
les options /v+ et /v- pour activer ou desactiver selectivement les 
informations de debogage, module par module (mais pas sur la meme ligne 
de commande que /v). Par exemple, la commande 

TLINK modi /v+ mod2 mod3 /v- mod4 

inclut des informations de debogage pour les modules modi et mod3, mais ni 
pour modi ni modi. 

/wxxx active (/wxxx) ou desactive (/w-xxx) les messages de mise en garde de 
TLINK, ou xxx peuvent etre (l'option par defaut implique que TLINK 
enverra la mise en garde sans que vous l'ayez specialement activee) : 



Tableau 9.4 

Mises en garde 

TLINK32 s 



Par defaut Option /w 

■ bdl 

def 
dpi 

■ dup 

■ ent 
imt 
inq 

■ srf 



Description EDI 

Utilisation de liaisons implantees dans des DLL (peut provoquer un 
mauvais fonctionnement de la DLL). 

Pas de fichier .DEF ; utilisation des valeurs par defaut. 

Avertit de I'existence d'un symbole en double dans .LIB. 

Symbole en double (mise en garde pour les fichiers .OBJ). 

Pas de point d'entree. 

Import ne correspond pas a la definition precedente. 

Extern non qualifie avec import. 

Relocation differentiele depassee. 

Mise en garde "Pas de pile". 
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/x dit a TLINK de ne pas generer de fichier de mappe. TLINK cree 
generalement des fichiers de mappe qui enumerent les segments du 
programme, l'adresse de demarrage du programme et toute mise en garde 
ou tout message d'erreur TLINK (par defaut, l'option MapFile I Segments, 
qui n'a pas d'option de ligne de commande, est activee). 

/ye commande l'utilisation par TLINK de la memoire paginee pour les 
tampons d'E/S. Si TLINK a besoin d'espace memoire supplementaire pour 
les structures de donnees actives (en cours de lecture de fichiers objets ou 
d'ecriture dans le fichier executable), soit il efface les tampons, soit il les 
permute avec la memoire paginee. 

Quand il lit des fichiers, TLINK efface le tampon d'entree de sorte que 
l'espace disponible puisse etre utilise pour d'autres structures de donnees. 
Quand TLINK cree un executable, il met le tampon a la bonne place dans le 
fichier executable. Dans les deux cas, vous pouvez augmenter sensiblement 
la vitesse de 1' edition de liens en permutant sur la memoire paginee. Par 
defaut, la fonction sur la memoire paginee est active et celle d'echange sur la 
memoire etendue desactivee. Si l'echange est active et s'il n'y a pas 
suffisamment d'espace memoire, l'echange n'a pas lieu. 

Cette option prend plusieurs formes qui sont indiquees ci-apres ; 

■ /ye ou /ye+ active sur la memoire paginee (valeur par defaut). 

■ ye- desactive sur la memoire paginee (inactive par defaut). 

/yx commande l'utilisation par TLINK de la memoire etendue pour les 
tampons d'E/S. Par defaut TLINK peut utiliser jusqu'a 8 Mo de memoire 
etendue. Vous pouvez modifier l'utilisation de la memoire etendue par 
TLINK en selectionnant l'une des options suivantes : 

■ /yx+ utilise toute la memoire etendue disponible, dans la limite de 8 Mo. 

■ /yxn utilise la memoire etendue uniquement dans la limite de n ko. 
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Fichiers de definition de modules 



IMPDEF cree des 

fichiers de definition de 

modules, tandis que 

IMPLIB cree des 

bibliotheques 

d'importation a partir de 

fichiers de definition de 

modules. 

Reportez-vous au 

chapitre 10 pour tout 

complement 

d'information sur ces 

outils. 



Instruction CODE 



Cette section decrit les fichiers de definition de modules et les instructions 
qui apparaissent dans ces fichiers. Les fichiers de definition de modules 
donnent a TLINK des informations sur le contenu et les exigences systeme 
d'une application Windows. Plus precisement, un fichier de definition de 
modules : 

■ Nomme les fichiers .EXE ou .DLL. 

■ Identifie le type d'application. 

■ Enumere les fonctions importees et exportees. 

■ Decrit les attributs des segments de code et de donnees, et vous permet 
d'inserer les attributs d'autres segments de code. 

■ Precise la taille de la pile. 

■ Permet l'integration d'un programme de remplacement temporaire. 

Reportez-vous au Guide du programmeur pour plus de details sur l'utilisation 
et pour des exemples de fichiers de definition de modules. 

CODE definit les attributs par defaut des segments de code. Les segments 
de code peuvent prendre n'importe quel nom, mais doivent appartenir a des 
classes de segments dont le nom se termine par CODE (par exemple CODE 
ou MYCODE). La syntaxe est la suivante : 



TLINK 

CODE [ F IXED | MOVEABLE ] 

[DISCARDABLE | NONDISCARDABLE] 
[PRELOAD | LOADONCALL] 



TLINK32 

[PRELOAD | LOADONCALL] 
[EXECUTEONLY I EXECUTEREAD] 



FIXED (valeur par defaut) signifie que le segment reste toujours au meme 
endroit dans la memoire ; MOVEABLE signifie que le segment peut etre 
deplace. 

PRELOAD signifie que le code est charge quand le programme d'appel est 
charge. LOADONCALL (valeur par defaut) signifie que le code est charge 
quand il est appele par le programme. 

DISCARDABLE signifie que le segment peut etre supprime s'il n'est plus 
utile (implique qu'il soit MOVABLE). NONDISCARDABLE (valeur par 
defaut) signifie que le segment ne peut etre supprime. 
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EXECUTEONLY signifie qu'un segment de code peut etre uniquement 
execute. EXECUTEREAD (valeur par defaut) signifie que le segment de 
code peut etre lu et execute. 

PRELOAD signifie que le segment est charge quand le module est charge 
pour la premiere fois. LOADONCALL (valeur par defaut) signifie que le 
segment est charge quand il est appele. 



Instruction DATA DATA definit les attributs des segments de donnees. La syntaxe est la 

suivante : 

DATA [NONE | SINGLE | MULTIPLE] 
[READONLY | READWRITE] 
[PRELOAD | LOADONCALL] 
[SHARED | NONSHARED] 

■ NONE signifie qu'il n'y a pas eu de segment de donnees cree. Cette option 
n'est disponible que pour les bibliotheques. SINGLE (valeur par defaut 
des fichiers .DLL) signifie qu'un seul segment de donnees est cree et 
partage par tous les processus. MULTIPLE (valeur par defaut pour les 
fichiers .EXE) signifie qu'un segment de donnees est cree pour chaque 
processus. 

■ READONLY signifie que le segment de donnees peut etre uniquement lu. 
READWRITE (valeur par defaut) signifie que le segment de donnees est 
accessible en lecture et en ecriture. 

■ PRELOAD signifie que le segment de donnees est charge lors du premier 
chargement d'un module utilisant ce segment. LOADONCALL (valeur 
par defaut) signifie que le segment de donnees est charge lorsqu'il est 
sollicite pour la premiere fois (ceci n'est pas vrai pour les applications 

32 bits). 

■ SHARED (valeurs par defaut des fichiers .DLL 16 bits) signifie qu'un 
exemplaire du segment de donnees est partage par tous les processus. 
NONSHARED (valeur par defaut pour les programmes et fichiers .DLL 
32 bits) signifie qu'un exemplaire du segment de donnees est charge pour 
chaque processus qui a besoin d'utiliser le segment. 
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Instruction 
DESCRIPTION 



Instruction 
EXETYPE 



Instruction 
EXPORTS 



DESCRIPTION (facultatif) insere du texte dans le module d'application ; 
cette instruction est en principe utilisee pour inclure le nom de l'auteur, la 
date ou des informations de copyright. La syntaxe est la suivante : 

DESCRIPTION Texte' 

Texte est une chaine ASCII delimitee par des apostrophes. 

EXETYPE definit le type d'en-tetes par defaut du fichier executable (.EXE) 
pour les applications 16 bits. Vous pouvez laisser cette section pour les 
applications 32 bits, pour des besoins de compatibilite amont, mais si vous 
etes amene a changer EXETYPE, reportez-vous a l'instruction NAME, plus 
loin dans ce chapitre. La syntaxe d'EXETYPE est la suivante : 

EXETYPE WINDOWS 

EXPORTS definit le nom et les attributs des fonctions a exporter. Le mot 
reserve EXPORTS indique le debut des definitions. II peut etre suivi par 
n'importe quel nombre de definitions d'exportation, chacune sur une ligne 
distincte. La syntaxe est la suivante : 

EXPORTS 

NomExport [Ordinal] [RESIDENTNAME] [Parametre] 

■ NomExport est une chaine ASCII definissant le symbole a exporter : 

NomEntree [=NomInterne] 

Nomlnterne est le nom utilise a l'interieur de l'application pour faire 
reference a cette entree. NomEntree est le nom qui figure dans la table des 
entrees du fichier executable ; il est visible a l'exterieur. 

■ Ordinal definit la valeur ordinale de la fonction, comme suit : 

Q&ordinal 

ou Ordinal est un nombre entier indiquant le nombre ordinal de la 
fonction. 
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Quand une application ou un module DLL appelle une fonction exportee 
d'une DLL, le module appelant peut designer la fonction par son nom ou 
par son numero ordinal. II est plus rapide d'appeler la fonction par son 
numero ordinal car les comparaisons de chaines ne sont pas necessaires 
pour localiser la fonction. Pour economiser la memoire, exportez les 
fonctions par leur nombre ordinal (du point de vue de la DLL de la 
fonction) et importez/appelez-les par leur numero ordinal (du point de 
vue du module solliciteur). 

Quand une fonction est exportee par son numero ordinal, son nom se 
trouve dans la table des nom non-residents. Quand elle est exportee par 
son nom, le nom se trouve dans le table des noms residents. La table des 
noms residents d'un module donne est en memoire chaque fois que ce 
module est charge ; la table des noms non-residents ne Test pas. 

■ RESIDENTNAME indique que le nom de la fonction doit etre en 
permanence resident. Ceci n'est utile que pour exporter par le numero 
ordinal (si le nom n'etait pas resident par defaut). 

■ Parametre est un entier facultatif qui precise le nombre de mots que la 
fonction veut transmettre comme parametres. 

Instruction IMPORTS definit le nom et les attributs des fonctions a importer de DDL. 

IMPORTS Au lieu d'enumerer les fonctions a importer dans l'instruction IMPORTS, 

vous pouvez : 

■ Indiquer une bibliotheque d'importation DLL sur la ligne de commande 
TLINK, 

ou 

■ Inclure la bibliotheque d'importation DDL dans le gestionnaire de projet 
del'EDI. 

Si vous programmez une application 32 bits, utilisez import pour 

importer toute fonction, classe ou donnee recherchees ; pour les applications 

16 bits, vous devez utiliser import avec des classes. Reportez-vous au 

Guide du programmeur pour de plus amples informations sur l'utilisation 
de _ _import. 
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Le mot reserve IMPORTS signale le debut des definitions ; il est suivi de 
n'importe quel nombre de definitions d'importation, chacune sur une ligne 
distincte. La syntaxe est la suivante : 

IMPORTS 

[NomInterne=] NomModule . Entree 

■ Nomlnterne est une chaine ASCII qui precise le nom unique utilise par 
l'application pour appeler la fonction. 

■ NomModule indique un ou plusieurs caracteres ASCII majuscules qui 
definissent le nom du module executable contenant la fonction. Ce nom 
doit etre le meme que celui du fichier executable. Par exemple, le fichier 
SAMPLE.DLL a pour nom de module SAMPLE. 

■ Entree designe la fonction a importer, soit une chaine ASCII designant la 
fonction, soit un entier correspondant au nombre ordinal de la fonction. 



Instruction LIBRARY definit le nom d'un module DLL. Un fichier de definition de 

LIBRARY modules peut contenir soit une instruction LIBRARY pour designer une 

DLL, soit une instruction NAME pour designer un programme. 

Tout nom de module de bibliotheque doit correspondre au nom du fichier 
executable. Par exemple, la bibliotheque MABIB.DLL a pour nom de 
module MABIB. La syntaxe est la suivante : 

LIBRARY NomBiblio [INITGLOBAL | INITINSTANCE] 

■ NomBiblio (facultatif) est une chaine ASCII qui definit le nom du module 
de la bibliotheque. Si vous n'indiquez pas de NomBiblio, TLINK utilise le 
nom du fichier en supprimant l'extension. Si le fichier de definition de 
modules ne comporte ni instruction NAME ni instruction LIBRARY, 
TLINK utilse par defaut une instruction NAME sans parametre 
NomModule. 

■ INITGLOBAL signifie que la routine d'initialisation de la bibliotheque 
n'est appelee que lorsque le module de bibliotheque est charge pour la 
premiere fois dans la memoire. INITINSTANCE signifie que la routine 
d'initialisation est appelee chaque fois qu'un nouveau processus utilise la 
bibliotheque. 
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Instruction NAME NAME est le nom du module executable de l'application. Le nom du 

module permet d'identifier le module quand vous exportez des fonctions. 
Pour les applications 32 bits, NAME doit figurer avant EXETYPE. Si NAME 
et EXETYPE n'indiquent pas le meme type d'application, c'est le type 
indique par NAME qui est utilise. La syntaxe est la suivante : 

NAME NomModule [WINDOWSAPI] | [WINDOWCOMPAT] 

NomModule (facultatif) correspond a un ou plusieurs caracteres ASCII 
majuscules designant le module executable. Ce nom doit correspondre au 
nom du fichier executable. Par exemple, une application avec le fichier 
executable SAMPLE.EXE aura pour nom de module SAMPLE. 

Si NomModule n'est pas indique, TLINK considere que le nom du module 
correspond au nom du fichier executable. Par exemple, si vous n'indiquez 
pas de nom de module et si le fichier executable s'appelle MYAPP.EXE, 
TLINK considere que le nom du module est MYAPP. 

Si le fichier de definition de modules ne comporte ni instruction NAME ni 
instruction LIBRARY, TLINK utilise par defaut une instruction NAME sans 
parametre NomModule. 

WINDOW API est un fichier Windows executable equivalant a l'option 
TLINK32 /aa. 

WINDOWCOMPAT est un fichier executable en mode caracteres 
compatible Windows, equivalant a l'option TLINK32 /ap. 



Instruction SEGMENTS definit les attributs des segments supplementaires de code et de 

SEGMENTS donnees. La syntaxe est la suivante : 

SEGMENTS 

NomSegment [CLASS ' NomClasse' ] [MinAlloc] 
[SHARED | NONSHARED] 
[PRELOAD | LOADONCALL] 

■ NomSegment est une chaine de caracteres qui designe le nouveau segment. 
Cela peut etre n'importe quel nom, y compris les noms de segments 
standard _TEXT et _DATA qui correspondent aux segments de code et de 
donnees standard. 

■ NomClasse (facultatif) est le nom de classe du segment concerne. Si le nom 
de classe n'est pas indique, TLINK utilise le nom de classe CODE. 
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Instruction 
STACKSIZE 



Instruction STUB 



■ MinAlloc (facultatif) est un entier designant le minimum de memoire 
requis pour le segment. TLINK et TLINK32 ne tiennent pas compte de 
cette valeur. 

■ SHARED (valeur par defaut pour les fichiers .DLL 16 bits) signifie qu'un 
exemplaire du segment est partage par plusieurs processus. 
NONSHARED (valeur par defaut des programmes et fichiers.DLL 32 bits) 
signifie qu'un exemplaire du segment est charge pour chaque processus 
qui a besoin du segment de donnees. 

■ PRELOAD signifie que le segment est charge immediatement ; 
LOADONCALL que le segment est charge quand il est sollicite ou appele 
(non pris en compte par TLINK32). Le compilateur de ressources peut 
annuler l'effet de l'option LOADONCALL et precharger des segments. 

STACKSIZE definit le nombre d'otects dont l'application a besoin pour sa 
pile locale. L'application utilise la pile locale chaque fois qu'elle appelle des 
fonctions. N'utilisez pas l'instruction STACK-SIZE pour les bibliotheques a 
liaisons dynamiques. La syntaxe est la suivante : 

STACKSIZE octets 

octets est la taille de la pile en nombre d'octets. 

STUB ajoute un fichier DOS executable designe par NomFichier au debut du 
module. Le fichier de remplacement temporaire executable affiche un 
message de mise en garde et s'interrompt si l'utilisateur essaie de l'executer 
dans le mauvais environnement (application Windows executee sous DOS, 
par exemple). 

Borland C++ ajoute un fichier de remplacement temporaire integre au debut 
de toute application Windows, sauf si un autre fichier de remplacement a 
ete indique avec l'instruction STUB. En principe vous ne devriez pas utiliser 
l'instruction STUB pour integrer WINSTUB.EXE, dans la mesure ou 
l'editeur de liens le fait automatiquement. La syntaxe est la suivante : 

STUB "NomFichier" 

NomFichier est le nom du fichier DOS executable qui doit etre ajoute au 
module. Le nom doit avoir la forme d'un nom de fichier DOS. 

Si le fichier designe par NomFichier n'est pas dans le repertoire en cours, 
TLINK le recherche dans les repertoires indiques par la variable 
d'environnement PATH. 
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Valeurs par defaut 
des f ichiers de 
definition de 
modules 



Le fichier de definition de module n'est pas aboslument indispensable pour 
produire un fichier Windows executable en Borland C++. 

Si aucun fichier de definition de module n'est indique, les valeurs utilisees 
par defaut sont les suivantes : 

CODE PRELOAD MOVEABLE DISCARDABLE 

DATA PRELOAD MOVEABLE MULTIPLE (for applications) 

PRELOAD MOVEABLE SINGLE (for DLLs) 
HEAP SIZE 4 96 
STACKSIZE 5120 (1048576 for TLINK32) 

A la place de l'instruction EXETYPE, l'editeur de liens de Borland C++ peut 
decouvrir le type de fichier executable que vous voulez produire en 
verifiant les valeurs definies dans l'EDI ou les options de la ligne de 
commande. 

Vous pouvez inclure une bibliotheque d'importation a la place de la section 
IMPORTS du fichier de definition de modules. 

Vous pouvez utiliser le mot reserve _export pour definir les fonctions 
d'exportation de votre code source C et C++, si vous voulez vous passer 
d'une section EXPORTS. Notez cependant que si vous utilisez _export pour 
exporter une fonction, cette fonction sera exportee par son nom et non par 
son numero ordinal (ce dernier etant generalement plus efficace). 

Si vous voulez modifier les valeurs par defaut de differents attributs, vous 
aurez besoin d'un fichier de definition de modules. 
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Les outils de compilation de 
ressources 

Ce chapitre decrit les outils de compilation de ressources de Borland. 

■ BRCC.EXE et BRCC32.EXE sont les compilateurs de ressources de 
Borland. lis compilent les fichiers .RC et generent des fichiers 
binaires .RES. 

■ RLINK.EXE et RLINK32.DLL (par le biais de TLINK32.EXE) sont les 
editeurs de liens de ressources qui traduisent les fichiers .RES en 
fichiers .EXE et marquent ces derniers comme executables Windows. 

■ BRC.EXE et BRC32.EXE sont les shells par lesquels BRCC, BRCC32, 
RLINK et RLINK32 peuvent etre lances tous ensemble. 

Sauf indication du contraire dans les pages qui suivent, tous les outils de 
compilation de ressources 32 bits fonctionnent comme leur equivalent 16 
bits. 

Les applications Windows offrent une interface standard. Les composantes 
de cette interface, les ressources, comprennent : 

■ Les menus 

■ Les boites de dialogue 

■ Les pointeurs 

■ Les icones 

■ Les graphiques Bitmap 

■ Les chaines de caracteres 

■ Les raccourcis-clavier 

■ Les polices 
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Les ressources sont def inies separement de votre code, puis lui sont 
associees lors de l'edition des liens. L'application ne charge les ressources en 
memoire que lorsqu'elle en a besoin, ce qui minimise la consommation de 
memoire vive. 

Les scripts de ressources (les fichiers .RC) sont des fichiers texte qui 
decrivent les ressources qu'utilise une application. Les outils BRCC et RC se 
servent de ces fichiers pour compiler les ressources en un fichier de 
ressources binaires (.RES). RLINK associe ensuite les fichiers .RES, qui 
contiennent vos ressources, a votre executable : cette phase s'appelle 
l'edition de liens des ressources ("resource linking"). 



BRCC : le compilateur de ressources 



BRCC est la version en ligne de commande du compilateur de ressources de 
Resource Workshop. II traduit les fichiers .RC en fichiers objet de ressources 
(.RES). La syntaxe de cet outil est la suivante : 

BRCC [options] <fichier>.RC 

Le tableau 10.1 decrit les options de BRCC. Notez que celles-ci peuvent etre 
entrees en minuscules comme en majuscules. 



Tableau 10.1 

BRCC (le 

compilateur de 

ressources de 

Borland) 



Option 



Description 



@Fichierde recherche 
-d <nom>[=<chaine>] 
-fo <fichier> 

-i <chemin> 



-v 
-x 
-?ou-h 

-30 
-31 
-w32 



Prend ce fichier en entree. 

Definit un symbole de pre-processeur 

Renomme le fichier de sortie .RES (par defaut, il s'agit du nom du 
fichier .RC d'entree). 

Ajoute un ou plusieurs repertoires (separes par un point-virgule) au 
chemin include. 

Sans effet. Ne sert qu'a assurer la compatibilite avec d'autres 
compilateurs. 

Affiche des messages ("verbeux"). 

Supprime le chemin include actuel. 

Affiche I'aide. 

Cree des fichiers .RES pour Windows 3.0. 

Cree des fichiers .RES pour Windows 3.1 . 

Cree des fichiers .RES pour Win32. 
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Comme le compilateur de RW, BRCC predefinit des constantes Windows 
liees aux ressources telles que WS_VISIBLE ET BS_PUSHBUTTON, ainsi 
que deux symboles speciaux lies au compilateur, RC_INVOKED et 
WORKSHOPJNVOKED. Ces symboles peuvent etre utilises dans le source 
en plus des instructions conditionnelles de pre-processeur pour controler la 
compilation. Le code ci-dessous, par exemple, accelere grandement la 
compilation : 

# ifndef WORKSHOPJNVOKED 

# include "windows. h" 

# endif 

L'exemple ci-dessous ajoute deux repertoires au chemin include et genere 
un fichier .RES au meme nom que le fichier .RC d'entree : 

brcc -i <repertoirel>; <repertoire2> <fichier>.RC 

L'exemple ci-dessous genere un fichier .RES avec un nom different du 
fichier .RC d'entree : 

brcc -fo <fichier>.RES <fichier>.RC 



RLINK : I'editeur de liens pour ressources 



RLINK combine un fichier .RES et un fichier .EXE pour generer un 
executable Windows. RLINK accepte plusieurs fichiers .RES mais un seul 
executable en entree. RLINK edite les liens des ressources en fixant les 
stringtables (tables de chaines) et les messagetables (tables de messages) et 
en liant ces ressources a l'executable. 

La syntaxe de cet outil est la suivante : 

RLINK [options] <f ichier> . RES <f ichier> . EXE 



Tableau 10.2 

Les options de 

RLINK 



Option 

@<Fichier de recherche> 
-d 

-fe <fichier> 
-fi <fichier> 
-k 



Description 

Prend ce fichier en entree. 

Supprime les ressources du fichier .EXE (aucun fichier .RES n'est 
indique). 

Renomme le fichier de sortie .EXE. 

Renomme le fichier d'entree .RES. 

Inhibe la reorganisation des segments pour un chargement rapide. 
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Tableau 10 2 0ption Description 

Les options de 



RLINK .,, . . 

(suite) " v Affiche des messages. 

-vx Liste les ressources mais ne les lie pas a I'EXE. 

-? ou -h Affiche I'aide. 

-30 Cree des fichiers .RES pour Windows 3.0. 

-31 Cree des fichiers .RES pour Windows 3.1 . 

-w32 Cree des fichiers .RES pour Win32. 

L'exemple ci-dessous lie les ressources du fichier .RES et genere un 
fichier .EXE : 

rlink <f ichier> . RES <f ichier> . EXE 

L'exemple ci-dessous lie les ressources de deux fichiers .RES et genere un 
fichier .EXE : 

rlink -fi <f ichier> . RES <f ichier> .RES <f ichier> .EXE 

L'exemple ci-dessous combine le code du programme .EXE en entree avec 
les ressources du fichier d'entree .RES et cree un fichier .EXE sous un nom 
different : 

rlink -f e<f ichier> . EXE <f ichier> .RES <f ichier> .EXE 

L'exemple ci-dessous prend en entree un fichier de commande .RLK, puis 
lie les ressources de trois fichiers .RES et genere un fichier .EXE : 

rlink <@f ichier> . RLK 

Le fichier .RLK d'entree contient les lignes suivantes : 

-fi <fichier>.RES 
-fi <fichier>.RES 
<fichier>.RES 
<fichier>.EXE 
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BRC : le shell de ressources 



BRC (Borland Resource Compiler) est un shell de compilateur de ressources. 
II lance BRCC ou RLINK (ou les deux) en fonction de la syntaxe de la ligne 
de commande. 

La syntaxe de cet outil est la suivante : 

BRC [options] <fichier>.RC [<f ichier> .EXE] 
Les options utilisables sont les suivantes : 



Tableau 10.3 
Les options de BRC 



Option Description 

-d <nom>=chaine Definit un symbole testable par la directive #IFDEF. 

-fe <fichier> Renomme le fichier .EXE. 

-fi <fichier> Indique d'autres fichiers .RES. 

-fo <fichier> Renomme le fichier .RES. 

-ihemin Ajoute un ou plusieurs repertoires (separes par un point-virgule) au chemin 
include. 

-khemin Ne pas reorganiser les segments pour un chargement rapide. 

-r Cree un fichier .RES sans I'ajouter au fichier .EXE. 

-v Affiche des messages. 

-x Force le compilateur a Ignorer la variable d'environnement INCLUDE lors de 
la recherche des fichiers include ou de ressources. 

-31 Cree des fichiers .RES pour Windows 3.1 . 

-w32 Cree des fichiers .RES pour Win32. 



La syntaxe de BRC peut varier en fonction du type de tache a effectuer. 

■ L'exemple ci-dessous compile le fichier .RC, cree un fichier .RES et l'ajoute 
a l'EXE : 

brc <fichier>.RC [<f ichier> .EXE] 

BRC recherche un fichier .EXE de meme nom que le fichier .RC. Ne 
specifiez le nom de l'EXE que s'il differe de celui du fichier .RC. 
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L'exemple ci-dessous cree un fichier .RES mais ne genere pas le 

fichier .EXE, meme si vous specifiez son nom dans la ligne de commande : 



brc -r <fichier>.RC 



L'exemple ci-dessous ajoute un fichier .RES existant a a un fichier 
executable. Ne specifiez le nom de l'EXE que s'il differe de celui du 
fichier .RC. 



brc <fichier>.RES [<f ichier> .EXE] 
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Les bibliotheques 



Ce chapitre decrit les outils qui vous permettent de manipuler les fichiers 
bibliotheques a partir de l'EDI ou de la ligne de commande. 

■ IMPLIB cree les bibliotheques d'import et IMPDEF cree les fichiers de 
definition de module (fichiers .DEF). Ces deux types de fichiers 
fournissent a l'editeur de liens des informations sur les fonctions 
importees depuis les DLL. 

■ TLIB est un utilitaire qui gere les bibliotheques de fichiers .OBJ (module 
objet). Une bibliotheque est un outil pratique pour gerer plusieurs 
modules objet comme s'il s'agissait d'un seul et unique element. 



IMPLIB : le bibliothecaire d'import 



IMPLIB cree des bibliotheques d'import a partir de fichiers .DLL, de fichiers 
de definition de module, ou des deux. L'EDI utilise IMPLIB comme 
traducteur pour une cible DLL (voir le chapitre 2 pour de plus amples 
informations sur le gestionnaire de projets et les cibles). Lorsque vous 
ajoutez une DLL a une cible, le gestionnaire de projets compile et lie les 
fichiers dependant de la DLL pour creer le fichier .DLL, puis lance IMPLIB 
pour creer un fichier .DLL. II est possible de lancer IMPLIB depuis l'EDI 
(voir le chapitre 6). 

Les bibliotheques d'import contiennent des enregistrements. Chacun 
contient le nom d'une DLL et indique a quel emplacement, dans cette DLL, 
se trouvent les fonctions a importer. Ces enregistrements sont lies a 
l'application par TLINK ou l'editeur de liens de l'EDI, et fournissent a 
Windows les informations requises pour resoudre les appels aux fonctions 
DLL. Une bibliotheque d'import peut etre substitute a une partie (ou a la 
totalite) de la section IMPORTS d'un fichier de definition de module. 
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Voir dans les pages qui 

suivent les indications 

sur la personnalisation 

d'une bibliotheque 

d'import a I'aide 

d'IMPDEFetd'IMPLIB 



Une DLL peut aussi 

avoir I'extension .EXE 

ou .DRV 



Si vous avez cree une application Windows, vous avez deja utilise la 
bibliotheque d'import IMPORT.LIB : il s'agit de la bibliotheque d'import 
pour les DLL Windows standards. IMPORT.LIB est liee automatiquement 
lorsque vous creez votre application dans l'EDI et lorsque vous utilisez BCC 
pour editer les liens. Vous ne devez specifier que vous souhaitez editer les 
liens avec IMPORT.LIB que si vous utilisez TLINK separement. 

Une bibliotheque d'import liste certaines (ou toutes) fonctions exportees 
pour une ou plusieurs DLL. IMPLIB cree une bibliotheque d'import a partir 
de DLL, a partir de fichiers de definition de module, ou a partir des deux. 

Pour creer une bibliotheque d'import pour une DLL, tapez : 



IMPLIB Options Bibliotheque [fichiers de definition. 



DLL. 



ou Options est une suite facultative d'options IMPLIB (voir le tableau 
11.1), Bibliotheque est le nom de la nouvelle bibliotheque d'import, 
fichiers de definition est une liste de fichiers de definition de 
module existants pour une ou plusieurs DLL, et DLL est une liste de DLL 
existantes. Vous devez specifier au moins une DLL et un fichier de 
definition de module. 



Tableau 11.1 
Options IMPLIB 

Les options doivent 

etre en minuscules 

et precedees d'un 

tiret ou d'une barre 

oblique ("/"). 



Option 



Description 

Fait la difference entre majuscules et minuscules dans les noms de symboles 
(MASYM et MaSym seraient ainsi consideres comme differents). 

IMPLIB doit ignorer WEP, la Windows Exit Procedure requise pour terminer 
une DLL. Utilisez cette option si vous specifiez plusieurs DLL dans la ligne de 
commande. 

Supprime les messages d'avertissement. 
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IMPDEF : le gestionnaire de fichiers de definition de module 



Les bibliotheques 

d'import permettent 

d'acceder aux fonctions 

d'une DLL Windows. 

Voir la page 

precedents pour de 

plus amples 

informations. 



IMPDEF prend en entree une DLL et genere un fichier de definition de 
module contenant une section export definissant les fonctions exportees par 
la DLL. La syntaxe est la suivante : 

IMPDEF Cible.DEF Source.DLL 

Ceci cree le fichier de definition de module Cible.DEF a partir de Source.DLL. 
Le fichier de definition de module resultant pourrait avoir le contenu 
suivant : 

LIBRARY Fichier 
DESCRIPTION 'Description' 
EXPORTS 

FonctionExport ^ordinal 



FonctionExport 



^ordinal 



ou Fichier est le nom du fichier racine de la DLL, Description est la valeur de 
l'instruction du meme nom si la DLL a ete linkee avec un fichier de 
definition de module contenant cette instruction, FonctionExport designe une 
fonction exportee, et ©ordinal est la valeur entiere ordinale de cette fonction. 



Les classes 
d'une DLL 



IMPDEF est utile pour une DLL contenant des classes C++. Si vous utilisez 
le mot cle _export lorsque vous definissez une classe, toutes les fonctions 
membre non-inline et tous les membres de donnees statiques de cette classe 
sont exportes. II est plus simple de laisser IMPDEF creer pour vous le fichier 
de definition de module car il liste toutes les fonctions exportees et inclut 
automatiquement les fonctions membres et les donnees membres statiques. 
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Les noms de fonctions etant non significatifs, il serait fastidieux de les lister 
toutes dans la section EXPORTS d'un fichier de definition de module pour 
creer une bibliotheque d'import a partir du fichier de definition de module. 
Si vous utilisez IMPDEF pour creer le fichier de definition de module, il 
inclut la valeur ordinale de chaque fonction exportee. Si le nom d'une 
fonction est non significatif, IMPDEF inclut aussi son nom original sous 
forme de commentaire place apres l'entree de cette fonction. En void un 
exemple : 

LIBRARY Fichier 

DESCRIPTION 'Description' 
EXPORTS 

NomFonctionNonSignif @ordinal ; NomOriginal 



NomFonctionNonSignif ^ordinal ; NomOriginal 

ou Fichier est le nom du fichier racine de la DLL, Description est la valeur de 
l'instruction du meme nom si la DLL a ete linkee avec un fichier de 
definition de module contenant cette instruction, NomFonctionNonSignif 
designe un nom de fonction non significatif, ©ordinal est la valeur entiere 
ordinale de cette fonction, et NomOriginal est le nom original de la fonction. 

Les fonctions IMPDEF cree un fichier source editable listant les fonctions exportees dans 

d'une DLL la DLL. Vous pouvez editer ce fichier .DEF pour qu'il ne contienne que les 

fonctions que vous desirez passer a une application, puis lancer IMPLIB sur 
le fichier modifie. Vous obtiendrez une bibliotheque d'import contenant des 
informations d'import pour un sous-ensemble specifique des fonctions 
d'export d'une DLL. 

Supposons que vous distribuiez une DLL contenant des fonctions utilisables 
par plusieurs applications ; chaque fonction d'export de cette DLL est 
definie par _export. Si toutes les applications utilisaient toutes ces fonctions, 
vous pourriez generer, a l'aide de IMPLIB, une seule bibliotheque d'import 
pour la DLL, que vous livreriez avec la DLL ; cette DLL fournirait des 
informations d'import pour toutes les fonctions d'export de la DLL. La 
bibliotheque d'import pourrait etre liee a n'importe quelle application, ce 
qui supprimerait le besoin, pour l'application cible, de lister toutes les 
fonctions de DLL qu'elle utilise dans la section IMPORTS de son fichier de 
definition de module. 
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Supposons maintenant que vous ne souhaitiez passer qu'une partie des 
exports de la DLL a une application. L'ideal serait d'avoir une bibliotheque 
d'import personnalisee liee a cette application - qui ne passerait que les 
informations d'import concernant les fonctions utilisees par application. 

Pour obtenir ce resultat, lancez IMPDEF sur la DLL linkee et compilee. 
IMPDEF genere un fichier de definition de module contenant une section 
EXPORT listant toutes les fonctions d'export. Supprimez alors de ce fichier 
les fonctions que vous ne voulez pas voir dans la bibliotheque d'import 
personnalisee, puis lancez IMPLIB sur le fichier modifie. Vous obtenez ainsi 
une bibliotheque d'import ne contenant que les informations d'import 
concernant les fonctions d'export listees dans la section EXPORTS du fichier 
de definition de module. 



TLIB : le Turbo bibliothecaire 



Lorsqu'il modifie une 

bibliotheque existante, 

TLIB cree une 

sauvegarde avec 

I'extension .BAK. 



Voir plus loin la section 

traitant de I'option /E 

pour de plus amples 

informations 



Les bibliotheques de Borland C++ ont ete generees avec TLIB. Vous pouvez 
utiliser cet outil pour creer ou modifier vos propres bibliotheques ou celles 
de Borland C++. Vous pouvez aussi utiliser TLIB pour : 

■ Creer une bibliotheque a partir d'un ensemble de modules objet. 

■ Ajouter des modules objet ou d'autres bibliotheques a une bibliotheque 
existante. 

■ Supprimer des modules objet d'une bibliotheque. 

■ Remplacer des modules objet dans une bibliotheque. 

■ Extraire des modules objet d'une bibliotheque. 

■ Lister le contenu d'une bibliotheque. 

TLIB peut aussi creer (et inclure dans le fichier bibliotheque) un dictionnaire 
etendu utilisable pour accelerer le processus d'edition des liens. 

Bien que TLIB ne soit pas indispensable pour creer des executables 
avec Borland C++, il permet de gagner du temps dans les gros projets de 
developpement. 



Pourquoi utiliser 
des bibliotheque 
de modules objet ? 



Quand vous programmez en C ou en C++, vous vous creez un ensemble de 
fonctions et de classes reutilisables. Grace a la modularity de ces langages, 
vous pouvez eclater ces fonctions en plusieurs fichiers sources compiles. 
Ainsi, une application peut n'utiliser qu'un sous-ensemble de ces fonctions. 
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Une bibliotheque de modules objet gere un ensemble de fonctions et de 
classes. Lorsque vous linkez votre application avec une bibliotheque, 
l'editeur de liens analyse la bibliotheque et ne selectionne que les modules 
requis pour application. 



Ligne de 
commande de TUB 



TapezTLiBpuis 

Entree pour afficher les 

options depuis la ligne 

de commande. 



La syntaxe de la ligne de commande de TLIB est la suivant (les parametres 
entre crochets sont optionnels) : 

TLIB [QF_rech] [option] bibliotheque [operations] [, fichierListe] 

Dans l'EDI, vous pouvez creer une bibliotheque comme cible dans un fichier 
de projet. Depuis TargetExpert, choisissez Static Library comme type de 
cible (voir le chapitre 2 pour de plus amples informations sur le gestionnaire 
de projets). TLIB est le traducteur par defaut des fichiers bibliotheque ; il 
utilise les options definies dans la section Librarian de la boite de dialogue 
Project Options (choisissez Options I Project dans le menu principal). 



Tableau 11.2 Options de TLIB 

Option Librarian (option EDI) 



Description 



@f_rech 



bibliotheque 



/C 

/E 

IPtaille 
10 
operations 



Differences entre majuscules et 
minuscules dans la bibliotheque. 
Creer un dictionnaire etendu 

Taille de la page de la bibliotheque. 

Effacer les commentaires. 



Le chemin d'acces complet du fichier de recherche a inclure. Vous 
pouvez en specifier plusieurs. 

Chemin d'acces complet de la bibliotheque a creer ou a manipuler. 
Ce parametre est obligatoire. Les caracteres jokers ne sont pas 
autorises. Par defaut, TLIB prend .LIB comme extension si vous n'en 
specifiez aucune. N'utilisez que cette extension car les compilateurs 
en ligne de commande BCC et BCC32, ainsi que l'EDI, requierent 
cette extension pour reconnaitre les fichiers bibliotheques. 
Remarque : Si la bibliotheque indiquee n'existe pas et si vous 
specifiez I'operation ADD, la bibliotheque est creee. 

Voir page suivante pour de plus amples informations. 

Voir page suivante pour de plus amples informations. 

Voir page suivante pour de plus amples informations. 

Supprime les enregistrements de commentaire de la bibliotheque. 

La liste des operations effectuees par TLIB. Aucun ordre particulier 
n'est requis. Si vous ne souhaitez que voir le contenu d'une 
bibliotheque, n'indiquez aucune operation. 
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Tableau 1 1 .2 Options de TUB (suite) 



fichierListe Generer un fichier liste 

Le nom du fichier listant le contenu de la bibliotheque, precede d'une 
virgule. Si vous omettez cette option, aucun fichier liste n'est genere. Le 
listage contient les noms de modules, classes par ordre alphabetique. 
L'extension par defaut de ce fichier est .LST. Les informations qu'il contient 
peuvent etre envoyees a l'ecran en utilisant CON comme fichierListe, et a 
l'imprimante en utilisant PRN. 



Les fichiers de 
recherche 



Lorsque vous utilisez de nombreuses operations, ou si vous specifiez 
regulierement les memes operations, nous vous recommandons de vous 
servir des fichiers de recherche. II s'agit de fichiers ASCII, pouvant etre crees 
avec l'editeur de Borland C++, contenant des commandes TLIB. Vous 
pouvez ainsi generer des commandes qui ne tiendraient pas sur une seule 
ligne de commande. Les fichiers de recherche peuvent : 

■ Contenir plusieurs lignes de texte ; utilisez le caractere & a la fin d'une 
ligne suivie par une autre. 

■ Inclure une liste de commandes partielle. II est possible de combiner les 
options de la ligne de commande avec les options d'un fichier de 
recherche. 

■ Etre utilises avec d'autres fichiers de recherche dans une ligne de 
commande TLIB. 



Distinction des 
majuscules et des 
minuscules dans 
les symboles : 
I'option/C 

N'utilisez pas I'option 

/C si vous avez 

I'intention d'utiliser une 

bibliotheque avec 

d'autres editeurs de 

liens, ou si vous voulez 

que d'autres puissent 

utiliser la bibliotheque. 



TLIB utilise un dictionnaire des symboles publics definis dans les modules 
de la bibliotheque. Si vous ajoutez un module a une bibliotheque, son 
symbole doit etre unique. Dans le cas contraire, TLIB affiche un message 
d'erreur et n'ajoute pas le module en question. 

Certains editeurs de liens n'etant pas sensibles a la difference entre 
majuscules et minuscules, TLIB refuse les noms de symboles dont la seule 
difference reside dans la casse ; ainsi, LOOKUP et Lookllp sont considered 
comme identiques. Cependant, TLINK est capable de faire la distinction 
entre les deux, grace a I'option TLIB /C. 
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Creation d'un 
dictionnaire 
etendu : I'option IE 



Choix du format de 
la page : I'option IP 



Pour accroitre les capacites de l'editeur de liens en ce qui concerne les liens 
de taille importante, vous pouvez utiliser TLIB pour creer un dictionnaire 
etendu et pour l'ajouter au fichier bibliotheque. Ce dictionnaire contient, 
dans un format compacte, des informations qui n'apparaissent pas dans le 
dictionnaire standard de la bibliotheque et qui permettent a TLINK de 
pre-traiter les fichiers bibliotheques pour que les modules non requis ne 
soient pas traites. 

Pour creer un dictionnaire etendu pour une bibliotheque que vous modifiez, 
utilisez I'option /E au lancement de TLIB pour ajouter, effacer ou remplacer 
des modules dans la bibliotheque. Cette option permet aussi de creer un 
dictionnaire etendu pour une bibliotheque que vous ne souhaitez pas 
modifier. Par exemple, si vous tapez TLIB /E bibliotheque, l'editeur 
de liens ajoute un dictionnaire etendu a la bibliotheque specifiee. 

Si vous utilisez /E pour ajouter un module bibliotheque contenant une classe 
C++ avec une f onction virtuelle, vous verrez le message d'erreur Library 
contains COMDEF records — extended dictionary not created. 

Toute bibliotheque DOS contient un dictionnaire qui apparait a la fin du 
fichier .LIB, apres les modules objet. Pour chaque module, le dictionnaire 
contient l'adresse (sur 16 bits) du module dans le fichier .LIB. Cette adresse 
est donnee par rapport a la taille de la page de bibliotheque (16 octets par 
defauts). 

La taille de la page de bibliotheque determine la taille combinee maximale 
de tous les modules objet dans la bibliotheque ; celle-ci ne peut exceder 
65 536 pages. La valeur par defaut minimale de 16 octets autorise une 
bibliotheque d'environ 1 Mo. Pour creer une bibliotheque plus grande, 
utilisez I'option /P pour augmenter la taille des pages. La taille de page doit 
etre une puissance de 2 et comprise entre 16 et 32 768. 

Tous les modules de la bibliotheque doivent commencer sur une limite de 
page. Par exemple, si la taille de page est de 32, 16 octets en moyenne sont 
perdus, pour des besoins de remplissage ("padding"), par module. Si vous 
essayez de creer une bibliotheque trop grande pour la taille de page 
specifiee, TLIB affiche un message d'erreur et vous suggere d'utiliser 
I'option /P avec la premiere taille de page superieure et disponible. 
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Suppression des 
enregistrements de 
commentaire : 
l'option/0 



Utilisez cette option pour supprimer des enregistrements de commentaire 
(debogage ou browsing) afin de reduire la taille de vos bibliotheques. 



Liste d'operations 



Pour remplacer un 

module, supprimez-le 

puis ajoutez le nouveau 

module. 

Les caracteres jokers 

ne sont pas autorises 

dans les noms de 

fichiers ou de modules. 



La liste d'operations passe des ordres d'execution a TLIB. Elle est composee 
d'une suite d'operations placees les unes apres les autres. Chacune consiste 
en un symbole d'une ou de deux lettres suivies d'un nom de fichier ou de 
module. Vous pouvez inserer des espaces entre les symboles d'action ou 
entre les noms de fichiers ou de modules, mais pas entre les caracteres d'un 
symbole ou d'un nom de fichier. 

La seule limite au nombre d'operations est la limite de 127 caracteres dans 
une ligne de commande, limite imposee par DOS. L'ordre dans lequel TLIB 
effectue les operations demandees est le suivant : 

1. Les extractions en premier. 

2. Les suppressions en second. 

3. Les ajouts en dernier. 

TLIB trouve le nom d'un module en enlevant les donnees concernant l'unite, 
le chemin et l'extension du fichier specif ie. TLIB fonctionne avec des valeurs 
par defauts raisonnables : ainsi, pour ajouter un module ayant l'extension 
.OBJ et situe dans le repertoire courant, vous ne devez specifier que le nom 
du module ; le chemin et l'extension .OBJ sont superflus. 

TLIB reconnait trois symboles d'action (-, + et *) que vous pouvez utiliser 
separement ou en paire pour obtenir un total de cinq operations. L'ordre des 
caracteres n'est pas important pour les operations qui utilisent une paire de 
caracteres. Les symboles et leur descriptions sont repertories dans le 
tableau 11.3 
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Tableau 11.3 

Symboles d'action 

de TUB 

Pour creer une 

bibliotheque, ajoutez 

des modules a une 

bibliotheque qui n'a 

encore jamais ete 

creee. 



Symbole Norn 



Description 



-* ou *- 



-+ ou +■ 



Ajouter 



Supprimer 



Extraire 



Extraire et supprimer 
Remplacer 



TUB ajoute le nom a la bibliotheque. Si aucune extension n'est 
specifiee, TUB prend .OBJ par defaut. Si le fichier est lui-meme 
une bibliotheque (extension .LIB), I'operation ajoute tous ses 
modules a la bibliotheque cible. Si I'un des modules a ajouter 
existe deja, TUB vous le signale et ne I'ajoute pas. 

TUB supprime de la bibliotheque les modules specifies. S'ils ne 
s'y trouvent pas, il vous le signale. Cette operation ne requiert 
qu'un nom de module, bien que le chemin, I'unite et I'extension 
soient autorises. 

TUB cree le fichier specifie en extrayant le module indique et en 
le copiant dans le nouveau fichier. Si le module n'existe pas, 
TUB affiche un message et ne cree pas le fichier. Si le fichier a 
creer existe deja, il est ecrase. 

TUB copie le module specifie dans le fichier indique, puis le 
supprime de la bibliotheque source 

TUB remplace le module specifie dans le fichier indique. 



Exemples 



Ces exemples montrent l'etendue des possibilites de TLIB. 

■ Pour creer la bibliotheque BIBLIO.LIB avec les modules X.OB], Y.OBJ et 
Z.OBJ, tapez TLIB BIBLIOTHEQUE +X +Y +Z 

■ Pour creer la bibliotheque BIBLIO.LIB et obtenir egalement une liste dans 
MALISTE.LST, tapez TLIB BIBLIO +X +Y + Z, MALISTE.LST 

■ Pour remplacer le module X.OBJ par une version plus recente, ajouter 
Y.OBJ et supprimer Z.OBJ de BIBLIO.LIB, tapez TLIB BIBLIO -+X +Y -Z 

■ Pour creer la bibliotheque ALPHA.LIB avec les modules A.OB J, B.OBJ... 
G.OBJ a l'aide d'un fichier de recherche : 

• Creez un fichier texte (appele ici ALPHA.RSP) contenant les instructions 
suivantes : 

+A.OBJ +B.OBJ + C.OB J & 
+D.OBJ +E.OBJ +F.OBJ & 
+G.OBJ + 

• Entrez ensuite la commande suivante : 

TLIB ALPHA 0ALPHA.RSP, ALPHA. LST 
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Utilisation de MAKE 



MAKE.EXE est un gestionnaire de projet en ligne de commande qui vous 
permet de compiler uniquement les fichiers d'un projet qui ont ete modifies 
depuis la derniere compilation (MAKER est une version en mode reel de 
MAKE). Si vous utilisez l'EDI, nous vous conseillons d'utiliser le 
gestionnaire de projet de l'EDI (voir le chapitre 2). 

Ce chapitre couvre les sujets suivants : 

■ Generalites sur MAKE 

■ Contenu d'un fichier MAKE 

■ Utilisation des regies explicites et implicites 

■ Les macros de MAKE 

■ Les directives de MAKE 



Generalites sur MAKE 



MAKE utilise les regies d'un fichier texte (MAKEFILE ou MAKEFILE.MAK 
par defaut) pour determiner quels fichiers doivent etre crees et comment les 
creer. Vous pouvez ainsi, par exemple, compiler un fichier .EXE si les 
fichiers .CPP contenant le source correspondant sont plus anciens que le 
fichier .EXE resultant. MAKE est tres utile lorsque vous generez un 
programme a partir de plusieurs fichiers, car il ne recompile que ceux que 
vous avez modifies. 

Deux types de regies (explicites et implicites) indiquent a MAKE quels 
fichiers dependent les uns des autres. MAKE compare alors les dates des 
fichiers d'une regie et decide de 1' execution d'une commande (les 
commandes portent en general sur la compilation ou l'edition des liens, 
mais il peut s'agir de pratiquement toutes les commandes du systeme 
d'exploitation). 
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MAKE accepte les 
caracteres jokers ? et * 

Pour obtenir de I'aide, 

tapez make - ? ou 

MAKE -h 



Pour placer les 

instructions de MAKE 

ailleurs que dans un 

fichier MAKE, voyez la 

section "Options de 

MAKE". 



La syntaxe generique de MAKE est la suivante : 

MAKE [options...] [cibles [s]] 

ou options sont les options de MAKE controlant son fonctionnement, et 
cibles sont les noms des fichiers du fichier MAKE a creer. Les options sont 
separees de MAKE par un seul espace. Les options et les cibles sont separees 
entre elles par un espace. 

Si vous tapez MAKE sur la ligne de commande, MAKE effectue les taches par 
defaut suivantes : 

1. MAKE recherche dans le repertoire courant le fichier BUILTINS.MAK, 
qui contient les regies que MAKE respecte si vous n'utilisez pas l'option 
-r. S'il ne le trouve pas, il le cherche dans le repertoire ou MAKE.EXE est 
place. Apres avoir charge BUILTINS.MAK, MAKE recherche un fichier 
appele MAKEFILE ou MAKEFILE.MAK. S'il n'en trouve aucun, il affiche 
un message d'erreur. 

2. Quand MAKE trouve le fichier MAKE, il tente de ne creer que le premier 
fichier cible dans ce fichier (mais la premiere cible peut forcer la creation 
d'autres cibles). MAKE verifie la date et l'heure des fichiers dependant 
de la premiere cible. S'ils sont plus recents que le fichier cible, MAKE 
execute les commandes cibles, ce qui met la cible a jour. Voir la section 
"Fichiers MAKE" pour de plus amples informations. 

3. Si un fichier dependant de la premiere cible est present sous forme de 
cible dans le fichier MAKE, MAKE verifie ses dependances et le cree 
avant de creer la premiere cible. Cette reaction en chaine s'appelle 
"dependance liee". 

4. Si MAKE ne peut creer les fichiers demandes, il efface le fichier cible qu'il 
a commence a creer. Pour eviter cela, utilisez la directive -precious (voir 
plus loin dans le chapitre). 

Pour arreter MAKE, appuyez sur Ctrl+C ou sur Ctrl+Pause. 
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BUILTINS.MAK BUILTINS.MAK contient les regies et macros standards utilisees par MAKE 

pour avant qu'il ne lise le fichier MAKE (pour que BUILTINS.MAK soit 
ignore, utilisez l'option -r). Servez-vous du fichier BUILTINS.MAK pour 
indiquer quelles instructions ou macros doivent etre executees a chaque 
lancement de MAKE. Voici le contenu par defaut de ce fichier : 

# 

# Borland C++ - (C) Copyright 1992 by Borland International 

# 

CC= BCC 

AS = TASM 

RC = RC 

.asm.ob j : 

$(AS) $(AFLAGS) $&.asm 
. c . exe : 

$(CC) $(CFLAGS) $&.c 
. c . ob j : 

$ (CC) $ (AFLAGS) /c $&.c 
.cpp . ob j : 

$(CC) $(CPPFLAGS) /c $&.cpp 
. re . res : 

$ (RC) $ (RFLAGS) /r $& 
.SUFFIXES: .exe . obj .asm . c .res .re 



Utilisation de 
TOUCH.EXE 



Les jokers * et ? 
sont autorises 

Important ! 



II est parfois necessaire de recompiler un fichier cible meme si vous ne 
l'avez pas modifie. L'un des moyens pour obtenir ce resultat est d'utiliser 
l'utilitaire TOUCH. Cet outil change la date et l'heure des fichiers specifies 
(leur dormant par defaut la date et l'heure actuelles), ce qui les rend plus 
recents que les fichiers dont ils dependent. 

Vous pouvez obliger MAKE a reconstruire un fichier cible en appliquant 
TOUCH a l'un des fichiers dont depend la cible. La syntaxe est la suivante : 

TOUCH fichier [fichier. . . ] 

TOUCH met a jour la date et l'heure des fichiers indiques. 

Avant d'utiliser TOUCH, verifiez les valeurs indiquees par l'horloge interne 
de votre ordinateur. En cas d'informations erronees, TOUCH et MAKE ne 
fonctionneront pas correctement. 
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Options de MAKE MAKE accepte plusieurs options en ligne de commande. Celles-ci, sensibles 

a la difference entre majuscules et minuscules, doivent etre precedees d'un 
"-" ou d'un "/". Ainsi, pour utiliser le fichier PROJETA.MAK comme fichier 
MAKE, tapez : MAKE - f PRO JETA . MAK (l'espace apres -f est facultatif). La 
plupart des options en ligne de commande ont une directive correspondante 
dans le fichier MAKE (voir les pages qui suivent pour de plus amples 
informations sur les directives). 

Tableau 12.1 : Options MAKE 



Option 



Description 



-h ou -? 

-B 
-Dmacro 

[-D]macro=[chatne] 

-\repertoire 

-K 

-N 

-U macro 
-W 

-\fichier 
-a 



-^repertoire 



-e 



-m 

-n 



Affiche les options de MAKE (les options par defaut sont suivies d'un +). 

Cree toutes les cibles, quelle que soit la date des fichiers. 

Definit macro comme un seul caractere, ce qui force toute expression lifdef macro dans le fichier 
MAKEaretournerVRAI. 

Definit la chaine en tant que macro. Si cette chaine contient des espaces ou des tabulations, entou- 
rez-la d'apostrophes ('). Le -D est facultatif. 

Recherche les fichiers include dans le repertoire specifie. 

Garde les fichiers temporaires creees par MAKE. Voir aussi KEEP dans les pages qui suivent. 

Execute MAKE comme NMAKE de Microsoft (voir les pages qui suivent pour de plus amples informa- 
tions). 

Annule les definitions precedentes de macro. 

Ecrit les options non-chaines courantes dans MAKE.EXE pour en faire des options par defaut. 

Utilise fichier ou fichier.MAK au lieu de MAKEFILE (l'espace apres -f est facultatif). 

Verifie les dependances des fichiers include et les fichiers include imbriques associes aux fichiers 
.OBJ et met a jour le fichier .OBJ si le fichier .H a ete modifie. Voir aussi -c. 

Place les informations d'auto-dependance en memoire cache pour de meilleures performances. A uti- 
liser avec -a. Ne pas utiliser si MAKE modifie les fichiers include (avec TOUCH depuis un fichier 
MAKE, en creant un en-tete ou des fichiers include, par exemple). 

A utiliser avec -S pour specifier I'unite et le repertoire utilises par MAKE lorsqu'il quitte la memoire. 
Cette option est sans effet avec MAKER.EXE. 

Ignore une macro si son nom est le meme qu'une variable d'environnement (MAKE utilise alors cette 
derniere). 

Ignore I'etat de sortie de tous les programmes lances depuis MAKE et continue le processus de crea- 
tion. 

Affiche la date et I'heure de chaque fichier traite. 

Affiche les commandes mais ne les execute pas (utile pour le debogage). 
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Tableau 12.1 : Options MAKE (suite) 



Option 



Description 



-p Affiche les definitions de macros et les regies implicites avant d'executer le fichier MAKE. 

-q Retourne si la cible est a jour (a utiliser dans un fichier batch). 

-r Ignore les regies definies dans BUILTINS.MAK. 

-s Supprime I'affichage des commandes a I'ecran. 

-S Retire MAKE de la memoire lors de I'execution des commandes, pour de meilleures performances. 

Cette option est sans effet sur MAKER. 



Definir des options 
pardefaut 



Attention ! 



L'option -W permet de definir certaines options de MAKE par defaut pour 
qu'elles soient activees a chaque lancement de MAKE. La syntaxe est la 
suivante : 



MAKE -option[-] [-option] 



-W 



Vous pouvez par exemple taper MAKE -m -W pour que la date des fichiers 
traites s'affiche toujours. Pour annuler cette commande, tapez MAKE -m- 
-W. Lorsque MAKE vous demande s'il doit enregistrer les modifications 
dans MAKE. EXE, tapez Y (oui). 

L'option -W ne fonctionne pas si le programme SHARE de DOS est lance : le 

message Fatal : unable to open file MAKE . EXE s'affiche. L'option 
-W ne fonctionne pas avec les options de MAKE suivantes : 

■ -Dmacro 

■ -Dmacro=[chaine] 

■ -^repertoire 

■ Aisymbole 

■ -\fichier 

■ -? ou -h 

■ -\repertoire 



Compatibility avec 

NMAKEde 

Microsoft 



Utilisez l'option -N si vous souhaitez traiter des fichiers MAKE crees pour 
NMAKE de Microsoft. Les changements occasionnes sont les suivants : 

■ MAKE interprete l'operateur < comme l'operateur && : les fichiers 
temporaires sont utilises comme fichiers de recherche, puis effaces. Pour 
conserver un fichier, utilisez l'option -K dans la ligne de commande ou 
KEEP dans le fichier MAKE. 
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En general, MAKE efface ses fichiers temporaires. 



<FICHTEMP.TXT! 
texte 



!KEEP 



Si vous ne voulez pas conserver un fichier temporaire, tapez NOKEEP ou 
uniquement le nom du fichier en question. Si vous utilisez NOKEEP avec un 
fichier temporaire, puis l'option -K avec MAKE, le fichier temporaire est 
efface. 

■ La macro $d est traitee differemment. Utilisez plutot lifdef ou lifndef. 

■ Les macros qui retournent un chemin d'acces ne retourneront pas le 
dernier "\". Par exemple, si $ ( ) retourne normalement C : \CPP \, elle ne 
retournera, avec -N, que C : \CPP. 

■ A moins qu'il n'existe la directive .suffixes correspondante, MAKE lit les 
regies en commencant par le bas du fichier MAKE. 

■ La macro $* est toujours convertie en nom de cible au lieu de celui de la 
dependance dans une regie implicite. 



Utilisation des fichiers MAKE 



Un fichier MAKE est un fichier ASCII d'instructions pour MAKE.EXE. 
MAKE suppose que votre fichier MAKE s'appelle MAKEFILE ou 
MAKEFILE. MAK, sauf si vous utilisez l'option -f (voir plus haut). 

MAKE cree les cibles specifiers dans la ligne de commande ou ne cree que la 
premiere cible trouvee dans le fichier MAKE (voir la section Cibles 
symboliques pour de plus amples informations). Un fichier MAKE peut 
contenir : 

■ Des commentaires. 

■ Des regies explicites. 

■ Des regies implicites. 

■ Des macros. 

■ Des directives. 
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Cibles symboliques Une cible symbolique force MAKE a creer des cibles multiples dans un 
fichier MAKE (il n'est pas necessaire d'utiliser les dependances liees). La 
ligne de dependance liste toutes les cibles que vous desirez creer. Vous 
n'entrez aucune commande pour une cible symbolique. 

Dans le fichier MAKE ci-dessous, la cible symbolique ToutesCibles cree a la 
fois FICHIER1 .EXE et FICHIER2.EXE : 

ToutesCibles: FICHIER1.EXE FICHIER2.EXE # Cette cible n' a 

# pas de commande 
FICHIER1.EXE: FICHIER1.0BJ 

BCC FICHIER1.0BJ 
FICHIER2.EXE: FICHIER2.0BJ 

BCC FICHIER2.0BJ 

Regies pour cibles Respectez les regies suivantes lorsque vous utilisez les cibles symboliques : 
symboliques 

■ Les cibles symboliques ne requierent pas de ligne de commande. 

■ Donnez a vos cibles symboliques un nom unique, different des noms de 
fichiers dans le repertoire courant. 

■ Nommez vos cibles symboliques en respectant les conventions de noms 
de fichiers de votre systeme d'exploitation. 



Regies explicites et implicites 



Les regies explicites et implicites qui gerent MAKE sont generalement 
definies comme suit : 

■ Les regies explicites concernent des fichiers specifiques. 

■ Les regies implicites sont suivies par MAKE lorsqu'il ne trouve pas de 
regie explicite. 

Le format d'une regie est le suivant : 

Ligne de dependance 
Commandes 
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La ligne de dependance est differente pour les regies explicites et implicites, 
mais les commandes sont les memes (pour de plus amples informations sur 
les dependances liees, voir les pages precedentes). 

MAKE supporte des regies multiples pour une seule cible. Vous pouvez 
ajouter des fichiers dependants apres la premiere regie explicite, mais un 
seul doit contenir une ligne de commande. Par exemple : 

Ciblel : dependancel dep2 dep3 dep4 dep4 
Ciblel : dep6 dep7 
bcc -c $** 



Syntaxe des regies 
explicite 



Utilisez les accolades si 

vous incluez le 

parametre chemin 



Les regies explicites sont des instructions indiquant a MAKE les noms de 
fichiers exacts. Elles nomment une ou plusieurs cibles, suivies d'un ou de 
deux caracteres ":". Un seul signifie qu'une regie est ecrite pour la cible, et 
deux signifient que plusieurs regies le sont. 

La syntaxe des regies explicites est la suivante : 

Cible [cible...] : [{chemin}] [dependance (s) ... ] 
[ commandes] 



Cible 



chemin 



dependance 



Nom et extension du fichier a mettre a jour. Cible doit 
etre en debut de ligne (les espaces et les tabulations ne 
sont pas autorises). Si vous avez plusieurs cibles, 
separez-les par des espaces ou par des tabulations. 
N'utilisez pas une cible plusieurs fois a la position de la 
cible d'une regie explicite dans un fichier MAKE. 

Liste des repertoires, separes par un point-virgule et 
places entre accolades, pointant sur les fichiers 
dependants. 

Fichier(s) dont la date et l'heure est verifiee par MAKE. 
Ce parametre doit etre precede par un espace. Si un 
fichier dependant apparait aussi dans le fichier MAKE 
comme cible, MAKE met a jour ou cree le fichier cible 
avant de l'utiliser comme dependance pour une autre 
cible. 
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Cibles uniques 
avec regies 
multiples 



■ commandes Toute commande du systeme d'exploitation. Les 

commandes multiples sont autorisees dans une regie. 
Les commandes doivent etre indentees d'au moins un 
espace ou d'une tabulation (voir la section traitant des 
commandes dans les pages qui suivent). 

Si la dependance ou les commandes continuent sur la ligne suivante, utilisez 
la barre oblique inverse ("\") ) a la fin de la ligne apres un nom de cible ou 
de fichier dependant : 

SOURCE.EXE: FILE1.0BJ\ 
FILE2 .OBJ\ 
FILE3.0BJ 
bcc filel.obj file2.obj file3.obj 

Une cible unique peut avoir plusieurs regies explicite. Vous devez utiliser le 
caractere "::" apres le nom de la cible pour que MAKE sache qu'il va traiter 
plusieurs regies explicites : 

. cpp . ob j : 

bcc -c -ncobj $ 

. asm. ob j : 

tasm /mx $, asmobj \\ 

mabiblio.lib :: fl.obj f2.obj 
echo Ajout des fichiers C 

tlib mabiblio — l-cobj\fl — l-cobj\f2 
mabiblio.lib :: f3.obj f4.obj 

echo Ajout des fichiers ASM 

tlib mabiblio -+asmobj\f3 -+asmobj\f4 



Syntaxe des regies 
implicites 



Une regie implicite commence par un chemin ou par un point et 
sous-entend une relation de fichiers dependant de la cible. Ses composant 
principaux sont des extensions de fichiers separes par des points. La 
premiere extension appartient a la dependance, la seconde a la cible. 

Si des dependances implicites ne sont pas a jour, MAKE execute les 
commandes associees a la regie. MAKE met a jour les dependances 
explicites avant les dependances implicites. 
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La syntaxe des regies implicites est la suivante : 

[{rep_source} ] . ext_source [{ rep_cible} ] 
[ commandes] 



. ext_cible 



■ rep_source Le repertoire des fichiers dependants. Separez les 

differents repertoires par un point-virgule. 

■ ext_source L'extension du fichier dependant. 

■ rep_cible Le repertoire des fichiers cibles (executables). Separez les 

differents repertoires par un point-virgule. 

■ ext_cible L'extension du fichier cible. 

■ : Marque la fin de la ligne de dependance. 

■ commandes Toute commande du systeme d'exploitation. Les 

commandes multiples sont autorisees dans une regie. 
Les commandes doivent etre indentees d'au moins un 
espace ou d'une tabulation (voir la section traitant des 
commandes dans les pages qui suivent). 

Si deux regies implicites correspondent a une extension cible mais 
qu'aucune dependance n'existe, MAKE utilise la regie implicite dont 
l'extension de la dependance apparait en premier dans la liste .SUFFIXES. 
Voir les pages qui suivent pour de plus amples informations sur les 
extensions. 



Regies explicites 
utilisees avec des 
commandes 
implicites 



Une cible dans une regie explicite peut prendre sa ligne de commande dans 
une regie implicite. L'exemple ci-dessous montre une regie implicite et une 
regie explicite sans ligne de commande : 

. c . ob j : 

bcc -c $ #Cette commande utilise la macro $ 
#decrite plus loin. 



.projet.obj: #Cette regie explicite utilise la commande 
#bcc -c .projet.obj: 
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Voir plus loin pour de 

plus amples 

informations sur les 

macros par defaut 

Syntaxe des 
commandes 



La commande de la regie implicite dit a MAKE de compiler PROJET.C (la 
macro $< remplace le nom pro jet . ob j par PRO JET . C). 



Les commandes peuvent etre toute commande du systeme d'exploitation, 
mais elles peuvent aussi inclure des macros et directives MAKE, ainsi que 
des operateurs speciaux non reconnus par les systemes d'exploitation (notez 
que vous ne pouvez pas utiliser le caractere " I " dans les commandes). Void 
quelques exemples de commandes : 

cd. . 

bcc -C mysource.c 

COPY *.OBJ C:\PROJETA 



bcc -c $ (SOURCE) 



# Les macros sont decrites dans les 

# pages qui suivent . 



La syntaxe des commandes est la suivante : 

[pre fixe . . . ] commandes 



Prefixes des 
commandes 



Les commandes dans les regies implicites et explicites peuvent avoir un 
prefixe modifiant leur traitement par MAKE. Le tableau 12.2 liste les 
prefixes que vous pouvez utiliser dans les fichiers MAKE. Ceux-ci sont 
decrits plus en detail dans les pages qui suivent. 



Tableau 12.2 
Prefixes des 
commandes 



Option Description 

@ Ne pas afficher la commande en cours d'execution. 

-valeur Arreter le traitement des commandes du fichier MAKE si le code de sortie 

retourne par la commande est superieur a valeur. Par defaut, MAKE arrete le 
traitement si le code de sortie est different de zero. Vous ne pouvez pas 
inserer d'espace entre "-" et "valeur". 

Continuer le traitement des commandes du fichier MAKE, quel que soit leur 
code de sortie. 

& Interpreter soit la macro $**, qui represents tous les fichiers dependants, soit 

la macro $?, qui represents tous les fichiers dependants modifies apres le 
fichier cible. Executer la commande une fois pour chaque fichier dependant 
dans la macro interpretee. 
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Utilisation de 

-valeuretde- 



Utilisation de @ La commande ci-dessous utilise le modificateur @ qui empeche l'affichage 

de la commande executee par MAKE : 

diff . exe : diff.obj 
@bcc diff.obj 

Les modificateurs -valeuret - controlent le traitement de MAKE en cas 
d'erreur. lis vous permettent de specifier si MAKE doit s'arreter si une 
erreur se produit ou si les erreurs depassent une certaine valeur. 

Dans l'exemple ci-dessous, MAKE poursuit son traitement si BCC ne 
s'execute pas normalement : 

cible.exe : cible.obj 
cible.obj : cible.cpp 
bcc -c cible . cpp 

Utilisation de & Le modificateur & lance une commande une fois par fichier dependant. II est 

tres utile pour les commandes qui n'acceptent pas de liste de fichiers comme 
parametres. Par exemple, 

copitout : fichierl.cpp fichier2.cpp 
&copy $** c:\temp 

lance deux fois la commande COPY comme suit : 

copy fichierl.cpp c:\temp 
copy fichier2.cpp c:\temp 

Sans le modificateur &, la commande COPY ne serait lancee qu'une fois. 



Operateurs de 
commandes 



Vous pouvez utiliser toute commande du systeme d'exploitation dans la 
section de commandes de MAKE. MAKE utilise les operateurs standards (+, 
-, etc.), mais il compte aussi les operateurs suivants : 



Tableau 12.3 
Operateurs MAKE 



Operateur 



> 
» 



Description 

Prendre les entrees de commande dans le fichier specifie plutot que dans 
I'entree standard. 

Envoyer la sortie de la commande dans le fichier specifie. 

Ajouter la sortie de la commande au fichier. 
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Tableau 12.3 

Operateurs MAKE 

(suite) 



Operateur 



Description 



« Creer un fichier inline temporaire et I'utiliser comme entree de la commande 

specifiee. 

&& Creer un fichier temporaire et inserer son nom dans le fichier MAKE. 

delimiteur Tout caractere autre que # et \ utilise avec < et && comme delimiteur de 

debut et de fin d'un fichier temporaire. Tout caractere sur la meme ligne et 
suivant immediatement le delimiteur de debut est ignore. Le delimiteur de fin 
doit etre place seul sur une ligne. 



Debogage avec 
fichiers temporaires 



Les fichiers temporaires peuvent vous aider a deboguer une suite de 
commandes en placant la commande executee par MAKE dans le fichier 
temporaire. Le nom des fichiers tempos commence a MAKE0000.@@@, ou le 
0000 s'incremente avec chaque fichier temporaire cree. Vous devez placer 
des delimiteurs apres && et a la fin de ce que vous envoyez au fichier 
temporaire ("!" est un bon choix). 

L'exemple ci-dessous montre comment les caracteres && demandent a 
MAKE de creer un fichier avec l'entree de TLINK : 

program.exe: A.obj B.obj 
TLINK /c &&! 
cOs . ob j $** 
program. exe 
program. map 
maths. lib cd.lib 



Le fichier de recherche cree par && contient les instructions suivantes 

cOs.obj A.obj B.obj 
program. exe 
program. map 
maths. lib cd.lib 
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Les macros de MAKE 



Attention a la casse 
des macros : MACR01 
est different de macrol . 



Une macro MAKE est une chaine qui est utilisee des que la macro est 
appelee dans un fichier MAKE. Les macros permettent de creer des 
fichiers-types que vous pouvez modifier au fil des projets. Par exemple, 
pour definir la macro NOMDELIB representant la chaine "mabiblio.lib", 

tapezNOMDELIB = mabiblio.lib. 

Lorsque MAKE rencontre la macro $(NOMDELIB), il utilise la chaine 
mabiblio.lib. 

Si MAKE rencontre une macro non definie, il cherche une variable 
d'environnement du systeme d'exploitation (definie par SET) portant le 
meme nom et utilise sa definition comme valeur. Par exemple, si vous avez 
entre $ (path) dans un fichier MAKE mais n'avez jamais defini path, 
MAKE utilisera la valeur de PATH dans votre AUTOEXEC. 



Definition des 
macros 



La syntaxe generale pour les macros des fichiers MAKE est la suivante : 

NomdeMacro = texte_a_utiliser 

■ NomdeMacro est limite a 512 caracteres. Les minuscules sont differenciees 
des majuscules. 

■ texte_a_utiliser est limite a 4 096 caracteres, y compris les signes de 
ponctuation et les espaces. 

Chaque macro doit etre sur une ligne distincte dans le fichier MAKE, placee 
au debut du fichier en regie generale. Si MAKE rencontre plusieurs 
definitions pour la meme macro, c'est la derniere qui prevaut. 

Vous pouvez definir une macro en utilisant l'option en ligne de commande 
-D (voir le debut du chapitre). Pour en definir plusieurs, separez-les par un 
espace : 

make -D RepSource = c:\projetA 

make command = "bcc -c" 



make command 



bcc option=-c 
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Vous trouverez ci-dessous les differences des syntaxe qui existent entre les 
macros entrees depuis la ligne de commande et les macros placees dans un 
fichier MAKE : 



Tableau 12.4 

Differences entres 

les deux types de 

macros 



Syntaxe 



Fichier MAKE 



Ligne de commande 



Espaces permis avant et apres "=" Oui 

Espace permis avant NomdeMacro Non 



Non 
Oui 



Utilisation des 
macros 



Pour utiliser une macro dans un fichier MAKE, tapez $(NomDeLaMacro). Vous 
pouvez utiliser des accolades ou des parentheses autour du nom de la 
macro. 

MAKE etend les macros a differents moments, selon leur position dans le 
fichier MAKE : 

■ Les macros imbriquees sont etendues lorsque la macro exterieure est 
lancee. 

■ Les macros dans les regies et les directives sont etendues lorsque MAKE 
ouvre le fichier MAKE. 

■ Les macros dans les commandes sont etendues lorsque la commande est 
executee. 



Substitution de 
chaines dans les 
macros 



MAKE permet de temporairement substituer des caracteres dans une macro 
deja definie. Par exemple, si vous avez defini la macro SOURCE ainsi : 

SOURCE = fl.cpp f 2 . cpp f 3 . cpp, vous pouvez remplacer ".CPP" par 
".OBJ" en tapant $ ( SOURCE : . CPP= . OBJ) . Ceci ne redefinit pas la macro. 

Regies concernant la substitution dans les macros : 

■ Syntaxe : 

$ (NomDeMacro : texte_original = texte_de_remplacement) . 

■ Ne placez pas d'espaces avant ou apres les deux points. 

■ Les caracteres de texte_original doivent etre absolument identiques, en 
terme de majuscules et de minuscules, a la definition de la macro. 
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MAKE vous permet maintenant d'utiliser les macros au sein de macros de 
substitution : 

MONEXT= . C 

SOURCE = fl.cpp f2.cpp f3.cpp 

$ (SOURCE: . cpp=$ (MONEXT) # Change fl.cpp en fl.c, etc. 



Macros par defaut 
de MAKE 



MAKE contient plusieurs macros par defaut que vous pouvez utiliser dans 
vos fichiers MAKE. Le tableau 12.5 donne leur definition et leur 
interpretation dans les regies implicites et explicites. 



Tableau 12.5 : Macros par defaut 



Macro Interpretation implicite 



Interpretation explicite 



Exemple 



$* chemin\fichier dependant 

$ chemin\dependant+ext 

$: chemin des dependants 

$. fichier dependant+ext 

$& fichier dependant cible 

$@ chemin\cible +ext 

$** chemin\dependant+ext 

$? chemin\dependant+ext 



chemin\cible 
chemin\cible+ext 
chemin de la cible 
cible + ext 

MYSOURCE 
chemin\cible+ext 
tous les dependants+ext 
anciens dependants 



C:\projeta\macible 
C:\projeta\macible.obj 
C:\projeta 
MYSOURCE.c 

C:\projeta\mYsource.c 

fichierl .cpp fichier2.cpp fichier3.cpp 

fichierl.cpp 



Tableau 12.6 

Autres macros par 

defaut 



Macro 

__MSDOS__ 

__MAKE__ 

MAKE 

MAKEFLAGS 

MAKEDIR 



Interpretation 

1 

0x0370 

make 

options 

repertoire 



Commentaire 

Si DOS actif. 

Version de MAKE (en hexadecimal). 

Norn de ['executable MAKE. 

Options entrees sur la ligne de commande. 

Repertoire de MAKE. 



Modification des 
macros par defaut 



Si les macros du tableau 12.5 ne vous donnent pas le resultat attendu, vous 
pouvez les modifier pour extraire la partie de la chaine qui vous interesse. 

Void la syntaxe a utiliser : 

$ {NomDeMacro [modificateur] ) 

Le tableau 12.7 liste les modificateurs de macros et donne un exemple 
d'utilisation. 
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Tableau 12.7 
Modificateurs de 
noms de fichiers 



Modificateur 


Partie du nom de fichier 
traitee 


Exemple 


Resultat 


D 


Unite et repertoire 


$(<D) 


C:\PROJETA\ 


F 


Base et extension 


$(<F) 


MYSOURCE.C 


B 


Base uniquement 


$(<B) 


MYSOURCE 


R 


Unite, repertoire et base 


$(<R) 


C:\PROJETA\MYSOURCE 



Les directives de MAKE 



Les directives de MAKE ressemblent aux directives des langages tels que 
Pascal ou C ; elles effectuent diverses operations de controle, telles que 
l'affichage des commandes avant leur execution. Les directives de MAKE 
commencent par un point ou par un point d'exclamation. Le tableau 12.8 
ci-dessous decrit les directives et leur option en ligne de commande 
correspondante (les directives ont priorite sur les options en ligne de 
commande). Vous trouverez apres ce tableau une description detaillee de 
chaque directive. 



Tableau 12.8 

Les directives de 

MAKE 



Directive 



Option 



Description 



.autodepend 

lelif 

lelse 

lendif 

lerror 

!if 

lifdef 



-a 



lifndef 




.ignore 


-i 


linclude 




Imessage 




.noautodepend 


-a- 


.noignore 


-i- 


.nosilent 


-s- 


.noswap 


-S- 



Active le controle de I'auto-dependance. 

Equivalent du else if de C 

Equivalent du else de C 

Termine une boucle !if, lifdef ou lifndef. 

Arrete MAKE et affiche un message d'erreur. 

Commence une instruction conditionnelle. 

Equivalent du ifdef de C, mais se rapporte aux macros et non aux 
directives #define. 

"If not defined" (si non defini) 

MAKE ignore la valeur de retour d'une commande. 

Inclut un fichier dans le fichier MAKE. 

Affiche un message depuis le fichier MAKE. 

Desactive le controle de I'auto-dependance. 

Desactive .ignore 

Affiche les commandes avant de les executer. 

MAKE ne sort pas de la memoire avant d'executer une commande. 
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Tableau 12.8 

Les directives de 

MAKE (suite) 



Directive 



.path.ext 

.precious 

.silent 

.suffixes 

.swap 

lundef 



Option 



Description 



MAKE recherche les fichiers avec I'extension specifiee dans les 
repertoires indiques. 

Conserve les cibles meme si le build echoue. 

N'affiche pas les commandes executees. 

Definit la regie implicite pour les dependances ambigues. 

MAKE sort de la memoire avant d'executer une commande. 

Efface une definition de macro. 



.autodepend 



Les auto-dependances se produisent dans les fichiers .OBJ ayant des fichiers 
.CPP, .C ou .ASM correspondant. Si cette option est activee, MAKE compare 
la date et l'heure des fichiers servant a creer le .OBJ avec celles du fichier 
.OBJ. Si les premieres sont anterieures, le fichier .OBJ est recompile. Vous 
pouvez utiliser .autodepend ou -a a la place des dependances liees (voir le 
debut du chapitre pour de plus amples informations a ce sujet). 



lerror 



La syntaxe de cette directive est la suivante : 

[error message 

MAKE s'interrompt et affiche la chaine "message", comme dans l'exemple 
ci-dessous : 

Fatal makefile exit code: Error directive: message affiche 

Imbriquez lerror dans les instructions conditionnelles pour arreter le 
traitement et afficher un message d'erreur : 

!if !$d(MAMACRO) 

# Si MAMACRO n'est pas definie 
lerror MAMACRO n'est pas definie... 
! endif 

Si MAMACRO n'est pas definie, MAKE affiche le message suivant : 

Fatal makefile exit code: Error directive: MAMACRO n'est 
pas definie . . . 



Resume des 
controles d'erreurs 



II existe quatre facons de desactiver les controles d'erreurs : 

■ La directive .ignore desactive le controle d'erreur pour la partie 
selectionnee du fichier MAKE. 
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L'option en ligne de commande -i desactive le controle d'erreur pour tout 
le fichier MAKE. 

L'operateur -valeur, saisi comme partie integrante d'une regie, desactive 
le controle d'erreur pour la commande associee si le code de sortie 
depasse la valeur specifiee. 

L'operateur - desactive le controle d'erreur pour la commande associee 
quel que soit le code de sortie. 



!if et autres 

directives 

conditionnelles 



La directive !if a le meme effet que l'instruction if du C. Comme illustre 
ci-dessous, la syntaxe de !if et des autres directives conditionnelles 
ressemble a celle des instructions conditionnelles du compilateur : 



!if condition 
lifdef macro 



!if condition 



!if condition 



! endif 



! else 



:elif condition 



! endif 



! endif ! endif 

Les expressions ci-dessous sont equivalentes : 

lifdef macro et! if $d (macro) 
lifndef macro et! if !$d (macro) 

Ces regies s'appliquent aux directives conditionnelles : 

■ Une directive !else est autorisee entre les directives !if, lifdef ou lifndef et 
lendif. 

■ Plusieurs directives !elif sont autorisees entre les directives !if, lifdef ou 
lifndef et lelse et lendif. 

■ Vous ne pouvez pas repartir de regies entre plusieurs directives 
conditionnelles . 

■ Vous pouvez imbriquer les directives conditionnelles. 

■ A chaque lif, lifdef et lifndef doit correspondre une instruction lendif 
dans le fichier source. 
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Les informations ci-dessous peuvent etre inserees entre les directives !if et 
tendif : 

■ Definition de macro 

■ Regie explicite 

■ Regie implicite 

■ Directive [include 

■ Directive terror 

■ Directive lundef 

La condition dans une instruction if represente une expression conditionnelle 
consistant en une constante decimale, octale ou hexadecimale suivi des 
operateurs du tableau 12.9. 



Tableau 12.9 

Operateurs 

conditionnels 



Operateur Description 



Operateur Description 



Negation 


? : 


Expression conditionnelle 


Complement de bit 


i 


NON logique 


+ Addition 


» 


Decalage a droite 


Soustraction 


« 


Decalage a gauche 


Multiplication 


& 


ET de niveau bit 


/ Division 


I 


OU de niveau bit 


% Reste 


A 


XOR de niveau bit 


&& ET logique 


>= 


Superieur ouegal* 


jl OU logique 


<= 


Inferieur ou egal * 


> Superieur 


= = 


Egalite * 


< Inferieur 


!= 


Inegalite * 


* Cet operateur fonctionne aussi avec 


les expressions 


de type chaine. 



'include 



MAKE evalue une expression conditionnelle comme un entier simple 32 bits 
non signe ou comme une chaine litterale. 

Cette directive est semblable a la directive de pre-traitement #include de C 
et de C++ : elle vous permet d'inclure le contenu d'un autre fichier texte 
dans le fichier MAKE. 

! include fichier 
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message 



Vous pouvez placer le nom du fichier entre guillemets ou entre les signes et 
et imbriquer les directives sans limite de profondeur, mais vous ne pouvez 
pas avoir plusieurs directives [include dans votre fichier MAKE. Le cas 
echeant, le message d'erreur cycle in the include file s'affiche. 

Les regies, les commandes et les directives doivent etre completes au sein 
d'un fichier source : il n'est pas permis de commencer une commande dans 
un fichier [include et de la finir dans le fichier MAKE. 

MAKE recherche les fichiers [include dans le repertoire courant si vous 
n'utilisez pas l'option -I pour specifier un repertoire different. 

La directive [message permet d'afficher des messages a l'ecran depuis un 
fichier MAKE. Ces messages vous servent a deboguer un fichier MAKE qui 
ne fonctionne pas comme vous le souhaiteriez. Ainsi, si une definition de 
macro vous pose des problemes, inserez cette ligne dans le fichier MAKE : 

Imessage La macro est definie ici comme $ (NomDeMacro) 

Lorsque MAKE interprete cette ligne, il affiche ce message, ainsi que le nom 
de la macro. 



.path.ext 



La directive .path.ext indique a MAKE ou rechercher les fichiers ayant une 
extension precise. L'exemple ci-dessous indique a MAKE que les fichiers .C 
sont dans C:\SOURCES ou dans C:\FICHIERS et que les fichiers .OBJ sont 
dans C:\OBJS. 

.path.c = C: \SOURCES;C: \FICHIERS 
.path.obj = C:\OBJS 



.precious 



Si un build de MAKE echoue, le fichier cible est efface. Cette directive 
interdit la suppression des fichiers cibles dans ce cas. 

La syntaxe est la suivante : 

.precious: cible [cible] . . . [cible] 



.suffixes 



Cette directive indique a MAKE l'ordre (par extension de fichiers) de 
creation des regies implicites. 

La syntaxe est la suivante : 

.suffixes: . ext [ . ext] [ . ext] . . . [.ext] 



Chapitre 12, Utilisation de MAKE 



227 



ou .ext represente l'extension du fichier dependant dans les regies 
implicites. Par exemple, vous pouvez inclure la ligne .suffixes: .asm 
. c . cpp pour que MAKE interprete les regies implicites en commencant 
par celles qui dependent de fichiers .ASM, puis .C, puis .CPP quel que soit 
leur ordre dans le fichier MAKE. 

Les exemples ci-dessous illustrent un fichier MAKE contenant une directive 
.suffixes qui force MAKE a rechercher un fichier source (MONPROG.EXE), 
d'abord avec l'extension .ASM, puis .C, puis .CPP. S'il trouve le premier, il 
cree MONPROG.OBJ en chargeant TASM, puis TLINK. S'il ne trouve pas 
MONPROG.ASM, il passe aux instructions suivantes. 

.suffixes .asm . c .cpp 

monprog.exe: monprog.obj 
tlink monprog.obj 

.cpp . ob j : 

bcc -P $< 
. asm. ob j : 

tasm /mx $< 
. c . ob j : 

bcc -P- $< 

lundef La syntaxe de cette directive est la suivante : 

! unde f NomDeMa cro 

lundef ("undefine", supprimer la definition) reinitialise la macro specif iee 
(NomDeMacro). Le test lifdef NomDeMacro retourne ensuite la valeur FAUX. 
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Utilisation de 
macros dans les 
directives 



La macro $d est utilisee avec la directive !if pour effectuer certains 
traitements si la macro specifiee est definie. L'instruction $d est suivie d'un 
nom de macro entre parentheses ou entre accolades, comme dans l'exemple 
ci-dessous : 



!if $d (debug) 

bcc -v fl.cpp f 2 . cpp 



! else 
bcc -v- 



#Si DEBUG est definie, 
#compiler avec les informations 
#de debogage . 
#dans le cas contraire, 
#compiler sans les informations 
#de debogage . 



Attention ! 



f 1 . cpp f 2 . cpp 

! endif 
N'utilisez pas la macro $d lorsque MAKE est lance avec l'option -N. 



Macros vides 



Si une macro n'est pas definie, lifdef NomDeMacro retourne la valeur FAUX. 
Si elle est vide, la valeur VRAI est retournee. Une macro vide ne contient 
que des espaces (places a droite du signe egal) ou aucun caractere : 



MACROVIDE = 



Les instructions ci-dessous definissent une macro vide dans la ligne de 
commande MAKE : 



MACROVIDE = 

ou 

-DMACROVIDE 
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Utilisation de Resource Workshop 



Cette section du Guide de Vutilisateur decrit l'emploi de Resource Workshop. 
Cet outil integre l'ensemble du processus de conception et de compilation 
des ressources destinees a des applications sous Microsoft Windows version 
3.0 ou plus. 

Resource Workshop possede les caracteristiques suivantes = 

■ Travail sur les ressources en format texte ou binaire. Des editeurs 
graphiques vous permettent d'intervenir sur des fichiers binaires, et un 
editeur de texte autorise 1' edition des ressources sous forme de scripts 
ressource. 

■ Gestion facile de centaines de ressources dans des dizaines de fichiers. 

■ Fonctions d'annulation et de re-application des modifications sur plusieurs 
niveaux. 

■ Decompilation des fichiers ressource binaires de facon a pouvoir modifier 
les ressources d'un programme meme si vous n'avez pas acces au code 
source. 

Quatre fichiers en ligne sont fournis pour Resource Workshop. lis 
fournissent des informations tres detaillees, qui n'interesseront que les 
utilisateurs chevronnes. 



BWCCAPI.TXT 
CUSTCNTL.TXT 



Decrit l'interface de programmation (API) BWCC 

Explique comment creer des classes de controle 
personnalisees. Des exemples de code C++ et 
Pascal sont proposes. Vous devez bien posseder 
ces notions pour creer vos propres classes de 
controles. 
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BWCCSTYL.TXT Expose les criteres pris en consideration pour la 

conception des boites de dialogue de style Borland 
avec les controles BWCC. 

RWINI.TXT Decrit les options qui ne peuvent etre definies que 

via le fichier WORKSHOP.INI. 
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Presentation de 
Resource Workshop 



Ce chapitre presente Resource Workshop et les ressources Windows. 

II decrit egalement les differents types de fichiers de ressource de Resource 

Workshop, et leur role dans le cadre d'un projet. 



Ressources Windows 



Les ressources correspondent aux elements visibles (graphiques) d'une 
application Windows. Exemple : lorsque vous ouvrez une boite de dialogue 
et que vous cliquez sur un bouton pour executer une tache, vous dialoguez 
avec les ressources du programme. Les ressources Windows sont decrites 
ci-dessous en detail. 

En general, les ressources des applications Windows sont distinctes du code 
du programme, ce qui permet d'apporter des modifications a l'interface 
utilisateur sans avoir a intervenir sur le fichier contenant ce code. 

Les ressources existantes et les ressources que vous creez ou personnalisez 
peuvent etre reutilisees dans differentes applications. 

Resource Workshop supporte les ressources Windows suivantes : 

■ Boites de dialogue. Fenetre (generalement de type "surgissante") qui permet 
les interactions entre l'application et l'utilisateur : l'application fournit 
(affiche) les informations destinees a l'utilisateur, et l'utilisateur 
selectionne parmi les options presentees pour ouvrir un fichier, modifier 
des couleurs, rechercher du texte, etc. 

■ Menus. Les applications Windows disposent d'une "barre menu", qui 
affiche le nom des menus disponibles. Chaque menu contient plusieurs 
elements de menu (commandes). Exemple : le menu Fichier, present dans 
la plupart des applications Windows, comprend des commandes de 
creation, ouverture, enregistrement et impression de fichiers. 
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Raccourcis. Touche ou combinaison de touches permettant de lancer une 
tache rapidement, sans passer par les menus. Exemple : certaines 
applications Windows disposent du raccourci Maj+lnserpour la 
commande Coller, qui permet de transferer le contenu du Presse-papiers 
Windows dans le fichier actif . En general, les raccourcis apparaissent dans 
le menu, a droite de la commande a laquelle ils sont associes. 

Tables de chaines. Table contenant les chaines de texte (messages systeme, 
messages d'erreur, descriptions diverses, etc.) necessaires a une 
application Windows. Ces chaines etant des ressources Windows 
distinctes du programme, vous pouvez les modifier sans avoir a intervenir 
sur le code source du programme. 

Graphiques par point. Representation binaire d'une image graphique, par 
exemple les fleches des barres de defilement, la case du menu Systeme ou 
les triangles de Reduction/ Agrandissement/Restauration. Chaque bit ou 
groupe de bits du graphique correspond a un pixel de l'image. 

Icones. Petit graphique par points de dimensions variables : 64x64 pixels 
(sous Windows 3.1 et moniteurs a tres haute resolution), 32x32 pixels ou 
16x32 pixels qui represente une fenetre en reduction. Vous pouvez creer 
des icones a l'aide de l'editeur Bitmap (decrit au chapitre 19) . 

Curseurs. Petit graphique par points de 32x32 pixels qui materialise sur 
l'ecran la position de la souris. Dans les applications Windows, le curseur 
change de forme en fonction de la nature de la tache en cours. Vous 
pouvez creer des curseurs a l'aide de l'editeur Bitmap (decrit au 
chapitre 19). 

Pour voir un exemple de curseurs personnalises, lancez l'editeur Bitmap 
pour editor une ressource graphique (graphique par points, icone, curseur 
ou police). Chaque fois que vous selectionnez un nouvel outil de dessin et 
que vous deplacez le curseur sur l'image en cours de modification, le 
curseur prend une forme correspondant a sa fonction. 

Polices. En principe, le terme "police" designe un ensemble de caracteres 
texte ; dans Resource Workshop, une police est plus generalement un 
ensemble de graphiques par points stockes et utilises ensemble. 

Les applications Windows disposent de nombreuses polices dont les 
caracteristiques conditionnent l'aspect des caracteres : type (Helvetica, 
Times Roman, etc.), taille (exprimee en points) et style (gras, italiques, 
etc.). Par exemple, vous pouvez afficher ou imprimer un texte en police 
Times Roman 10 points gras. 

Resource Workshop dispose des fonctions permettant de modifier les 
polices existantes et de creer des polices personnalisees. 
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■ Ressources utilisateur et ressources RC. Ces ressources, qui sont sensiblement 
identiques dans Resource Workshop, contiennent des donnees que vous 
pouvez ajouter dans un fichier executable. Exemple : si vous utilisez un 
gros bloc de donnees initialisees et accessibles en lecture seule (par 
exemple, un fichier texte), vous pouvez l'inserer dans un fichier 
executable en tant que ressource definie par l'utilisateur. 

L'ajout de ressources utilisateur dans une application permet d'optimiser 
la gestion de la memoire. En effet, de nombreuses applications Windows 
utilisent le modele de memoire intermediate, qui comprend un seul 
segment de donnees. Si vous disposez d'une grande quantite de donnees 
et que vous ne souhaitez pas que ces donnees resident en memoire de 
facon permanente, il vous suffit de les enregistrer comme ressource 
definie par l'utilisateur ; elles sont alors chargees uniquement sur ordre du 
programme. 

■ VERSIONINFO. Resource Workshop supporte la ressource 
VERSIONINFO (gestionnaire de version des fichiers .EXE de 
Windows 3.1). Pour plus de details sur VERSIONINFO, consultez l'aide 
en ligne de Resource Workshop ou la documentation de programmation 
de Windows 3.1. 

Pour l'edition des ressources, Resource Workshop dispose de deux editeurs 
: un editeur graphique convivial et performant, et un editeur de texte 
destine a la creation des scripts ressources. 

En outre, vous pouvez specifier un editeur externe pour travailler avec les 
fichiers projet qui ne subissent pas de compilation a l'ouverture. 



Types de fichiers ressources 



Les fichiers crees ou edites sous Resource Workshop peuvent etre au format 
binaire ou au format texte. Resource Workshop supporte egalement les 
formats Windows standard ; vous pouvez done utiliser des fichiers Resource 
Workshop avec des programmes qui generent du code binaire a partir de 
fichiers scripts de ressources. 

■ Fichier de compilation (.RC). Un fichier de compilation (extension .RC) est 
un fichier script (texte) qui contient les definitions d'une ou plusieurs 
ressources, definies sous forme de script ou de references pointant sur 
d'autres fichiers contenant des ressources. 

En general, un projet Resource Workshop doit comporter au moins un 
fichier .RC 
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■ Fichier compile. Un fichier compile (extension .RES) contient une ou 
plusieurs ressources compilees. 

En general, lors de la creation d'une application Windows, toutes les 
ressources sont compilees dans un seul fichier .RES, ce dernier etant 
ensuite lie au fichier executable. Avec Resource Workshop, il n'est pas 
necessaire de generer de fichier .RES, car Resource Workshop peut 
compiler les fichiers ressources et les lier directement a un fichier 
executable. 

■ Fichier executable et fichier DLL. Le fichier executable (extension .EXE) ou 
DLL est la destination finale des ressources definies sous Resource 
Workshop. En general, vous compilez un fichier .RC pour obtenir un 
fichier .RES, puis vous lancez un compilateur pour lier le fichier .RES au 
fichier executable ou DLL. Resource Workshop peut lier directement les 
ressources aux fichiers executables ou DLL, ce qui evite l'emploi du 
compilateur de ressources Microsoft. 

■ Fichier .DRV. Un fichier .DRV est un pilote de peripherique Windows, 
c'est-a-dire un cas particulier de fichier DLL. Les ressources de ces fichiers 
peuvent etre editees comme celles d'un fichier DLL. 

Si vous devez modifier les ressources d'un fichier binaire compile (fichier 
executable, DLL ou .RES), vous pouvez demander a Resource Workshop 
de decompiler le fichier, apporter les modifications requises et 
reenregistrer les ressources modifiees dans leur fichier binaire d'origine. 

■ Fichier dialogue (.DLG). Un fichier dialogue (.DLG) est un fichier script 
(texte) de ressources qui contient generalement la description d'une ou 
plusieurs boites de dialogue, mais qui peut egalement contenir toute autre 
ressource de fichier RC. 

Fichiers II existe quatre types de fichiers ressources bitmap : 

ressources bitmap 

■ Le fichier bitmap (extension .BMP) contient une ressource bitmap au 

format binaire. 

■ Le fichier icone (extension .ICO) contient une icone au format binaire. 

■ Le fichier curseur (extension .CUR) contient un curseur personnalise au 
format binaire. 
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Les fichiers polices existent sous forme binaire et sous forme de 
bibliotheques : 

• Le fichier polices binaire (extension .FNT) contient la definition d'une 
police personnalisee au format binaire. Vous pouvez utiliser l'editeur 
Paint de Resource Workshop pour creer une police et la memoriser dans 
un fichier .FNT. 

• Le fichier bibliotheque de polices (extension .FON) est une bibliotheque 
a liaisons dynamiques (DLL) contenant un repertoire de polices et une 
ou plusieurs polices. Les fichiers .FON doivent etre crees a l'exterieur de 
Resource Workshop ; une fois le fichier .FON cree, vous pouvez utiliser 
Resource Workshop pour le modifier. 
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Projets, ressources et 
identificateurs 



Ce chapitre decrit la fenetre projet. II explique comment controler, dans cette 
fenetre, l'affichage des ressources, mais aussi leur choix en vue d'une 
edition. II couvre aussi certains sujets generaux concernant les ressources : 
comment les ajouter ou les effacer des projets, comment les sauvegarder, et 
comment manipuler les identificateurs. 

Comme indique au chapitre 2, un projet est une collection d'une ou plusieurs 
ressources. Un fichier de projet (en general, .RC) contient une ou plusieurs 
ressources, fait reference a des fichiers contenant des ressources, ou encore 
les deux. 



Creation d'un projet 



Si vous avez un projet 

Ouvert, Resource 

Workshop le ferme 

d'abord (s'il a ete 

modifie, un message 

vous demande si vous 

souhaitez enregistrer 

les modifications avant 

de le termer). 



Pour creer un projet : 

1. Choisissez File I New Project. 

Decidez du type de fichier sur lequel vous voulez baser votre projet. Un 
projet caracteristique est base sur un fichier .RC, car ce type de fichier 
vous permet de travailler avec les differents types de ressources. 
Cependant, vous pouvez aussi choisir : 

■ .RC pour creer un fichier ressources script 

■ .RES pour travailler avec un fichier ressources binaire 

■ .CUR pour creer un projet contenant un curseur 

■ .ICO pour creer un projet contenant une icone 

■ .BMP pour creer un projet contenant un graphique par points 

■ .FNT pour creer un projet ne contenant que des polices 
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Cliquez sur le type de fichier projet souhaite, puis sur OK. 

Resource Workshop affiche votre nouveau projet, sans titre, dans la 
fenetre projet. Pour les projets .RC, vous devez specifier un fichier en-tete 
par defaut dans lequel Resource Workshop enregistrera les 
identificateurs. 



Ouverture d'un projet existant 



Un projet existant peut etre un projet cree avec Resource Workshop, ou un 
fichier .RC cree avec un autre logiciel de developpement de ressources. 
Vous pouvez aussi travailler avec les ressources d'une application 
Windows 3.0 ou ulterieure, meme si vous n'avez pas acces au code source. 
Si vous ne pouvez acceder qu'a un fichier executable, Resource Workshop 
decompile les ressources liees a ce fichier pour que vous puissiez les 
modifier. 

Pour ouvrir un projet existant : 

1. Choisissez File I Open Project. Resource Workshop affiche la boite de 
dialogue Open Project. 

2. Specifiez le fichier contenant le projet a ouvrir par l'une des procedures 
suivantes : 

■ Tapez le chemin d'acces et le nom du fichier et appuyez sur Entree. 

■ Choisissez un type de fichier, puis un nom de fichier dans la liste Files 
et cliquez sur OK. 

Resource Workshop reagit differemment selon que le projet est un fichier 
binaire ou un fichier contenant des donnees ressource. 

■ Si le projet est un fichier binaire (fichier executable, fichier .RES ou 
fichier DLL), Resource Workshop decompile les ressources en 
indiquant la progression de l'operation, sur le cote gauche de la ligne 
d'etat. 

■ Si le projet est un fichier RC ou un autre type de fichier contenant des 
donnees ressource (tel est generalement le cas), Resource Workshop lit 
le fichier directement (puisqu'aucune decompilation n'est necessaire), 
puis compile le fichier et chaque ressource en vous indiquant la 
progression de l'operation dans la boite de dialogue Compile Status. 

Si le compilateur rencontre une erreur, Resource Workshop affiche la 
boite de dialogue Compiler Error, qui contient la ligne (en surbrillance) 
ou se trouve l'erreur. 
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Pour editor le fichier avec l'editeur de texte externe specifie dans 
File I Preferences, appuyez sur le bouton Run Editor (boite de 
dialogue Compiler Error). Lorsque l'editeur apparait, apportez les 
modifications requises, enregistrez-les et quittez l'editeur. Vous devez 
ensuite recharger le projet. 

Une fois le projet compile ou decompile, Resource Workshop affiche la 
fenetre projet enumerant toutes les ressources. 



Comment utiliser la fenetre projet 



Lorsque vous creez un projet ou que vous ouvrez un projet existant, 
Resource Workshop affiche la fenetre projet. 

La fenetre projet agit comme un outil de gestion des fichiers, ce qui facilite la 
vue generale d'un projet. Meme si le projet contient de nombreuses 
ressources, vous pouvez rapidement les parcourir en faisant defiler le 
contenu de la fenetre projet. 

Pour un nouveau projet, la fenetre est vide, et vous devez y introduire des 
ressources en les creant ou en les ajoutant en tant que fichiers (ces sujets 
seront approfondis ulterieurement). 

Pour un projet existant, vous pouvez voir : 

■ La liste complete des fichiers du projet 

■ Les types de ressources de chaque fichier 

■ Les identificateurs (#define ou constantes) associes aux ressources, si le 
fichier contient des donnees ressource (ce n'est pas un fichier .EXE, .RES 
ou .DLL). Les identificateurs sont traites dans la section "Comment utiliser 
les identificateurs" de ce chapitre. 



Ressources Les ressources de votre fichier projet peuvent etre integrees dans le fichier ou 

integrees ou liees liees a celui-ci. 

■ Une ressource integree est stockee sous la forme d'un script ressource 
dans le fichier projet. Elle existe uniquement en tant que partie du projet 
dans lequel elle est stockee, et ne peut pas etre utilisee dans d'autres 
projets. 

■ Une ressource liee est un fichier distinct reference dans le fichier projet. 
Les ressources liees de type .RC, .DLG ou de format binaire peuvent etre 
utilisees dans d'autres projets. 
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Affichage 

d'informations 
dans la fenetre 
projet 



Utilisez le menu View pour determiner le mode d'affichage des 
informations dans la fenetre projet. Par defaut, la fenetre projet affiche la 
ressource selectionnee dans une fenetre de previsualisation. Utilisez 
View I Hide preview pour desactiver la previsualisation (dans la 
figure 14.1, la previsualisation est desactivee). Vous pouvez egalement 
decider de l'emplacement de la previsualisation par rapport au cadre du 
projet en choisissant View I Show vertical preview ou View I Show 
horizontal preview. 



Figure 14.1 

Fenetre projet 

montrant les 

ressources par fichier 



Cette ressource ICON 
est dans le fichier projet 
ou elle stockee en 
format script ressource. 



Fenetre projet 



mvproi.rc 

DIALOG: my_dialog 
ICON: myjco 

iconfile.ico 

ICON: nnyjcol " 



Cette ressource est un fichier 
distinct ICONFILE.ICO, en format 
binaire (comme toutes les 
ressources graphiques stockees 
dans des fichiers externes) 



Show Identifiers 



Affiche les identificateurs (#define ou constantes) du projet. Les 
identificateurs sont traites dans la section "Comment utiliser les 
identificateurs" de ce chapitre. 



Show Resources 



Enumere les types et les noms des ressources, tel que BITMAP: airplane. 
Dans la plupart des cas, cette option devra etre activee. 

Desactivez l'option Show Resources si vous ne desirez voir que les noms de 
fichiers, sans la liste des ressources qu'ils contiennent ou si seuls les 
identificateurs vous interessent. Si Show Resources est desactive, aucune des 
ressources definies dans le fichier projet ne peut etre selectionnee pour 
edition. 



Show Items 



Affiche un autre niveau de detail dans la fenetre projet. Lorsque Show Items 
est active, Resource Workshop affiche les elements de chaque ressource (par 
exemple, les POPUP et MENUITEM definis dans une ressource menu). 
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Show Unused Repertorie tous les types de ressources, qu'ils soient ou non utilises dans le 

r W> es projet. 

Show Unused Types est uniquement disponible lorsque View I By Type est 
active. 



Selection d'une Pour selectionner une ressource, utilisez la souris ou les touches flechees 

ressource pour la mettre en surbrillance dans la fenetre projet. 

■ Si vous avez choisi View I By Type, recherchez d'abord le type de 
ressource. La ressource est listee par nom, sous le type de ressource. 

■ Si vous avez choisi View I By File, recherchez la ressource sous son nom 
de fichier. Le nom de ressource est precede par le type de ressource et le 
signe deux points (:). 

Par exemple, dans la fenetre projet myproj.rc de la figure 14.1, la ressource 
Icone my_icol apparait sous le fichier iconfile.ico, sous le nom 
ICON:my_icol. 

Comment travailler avec les ressources 

Cette section decrit les taches executees avec les ressources. 



Chargement d'une Pour charger une ressource en vue de l'attribution d'un nom ou d'une 
ressource edition, executez l'une des procedures suivantes : 

■ Double-cliquez le nom de ressource (et non le type de fichier) dans la 
fenetre projet. Resource Workshop lance automatiquement l'editeur 
graphique approprie. Si aucun editeur de ressources n'est disponible (par 
exemple, pour une ressource definie par l'utilisateur), Resource Workshop 
lance l'editeur de texte interne. 

■ Selectionnez le nom de ressource dans la fenetre projet, puis choisissez 
soit Resource I Edit (pour ouvrir un editeur graphique), soit 
Resource I Edit as Text (pour ouvrir l'editeur de texte). 
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Editeurs de 
ressources 



Chaqueediteurde 

ressources est decrit 

dans le chapitre 

consacre a la 

ressource 

correspondante 



Lorsque vous double-cliquez sur l'un des types de ressource suivants dans 
la fenetre projet (ou que vous selectionnez un type et choisissez 
Resource I Edit), Resource Workshop charge l'editeur de ressources 
approprie : 

■ Si la ressource est une boite de dialogue, un menu, un raccourci ou une 
table de chaines, Resource Workshop charge un editeur specialement 
concu pour ce type de ressource. Pour les descriptions de ces editeurs, 
reportez-vous aux chapitres 15 a 18. 

■ Si la ressource est une ressource bitmap (icone, graphique par points, 
curseur ou police), Resource Workshop l'affiche dans l'editeur Bitmap. 



L'editeur de texte 
interne 



Pour une description du 

langage script de 

ressource, 

reportez-vous a I'index 

de I'aide en ligne. 



Les ressources definies par l'utilisateur et deux types de ressources 
predefinis (RCDATA et VERSIONINFO) peuvent uniquement etre edites au 
moyen de l'editeur de texte interne. 

Si la ressource est au format binaire (comme une boite de dialogue ou un 
menu), Resource Workshop la decompile pour vous permettre de travailler 
avec le script ressource. 

L'editeur de texte interne est similaire a l'editeur Notepad de Windows. II a 
recours aux touches Suppr, Debut, Fin, PgPrec, PgSuiv, Tab et Retour arriere. II est 
toujours en mode insertion. 

Lorsque vous entrez du texte, ne perdez pas de temps a le formater, 
Resource Workshop reorganise le texte a votre place lors de la compilation 
de la ressource. 

Si Resource Workshop identifie une erreur, il vous indique sa nature et vous 
ramene dans l'editeur de texte pour la corriger. 

Si vous desirez directement editer le script ressource sans l'assistance de 
Resource Workshop, ouvrez le fichier source avec l'editeur de votre choix, 
puis editez-le. Cependant, notez le point suivant : 

Lorsque Resource Workshop charge la ressource, il recompile le fichier et 
reformate le script ressource. S'il rencontre des commentaires dans le script 
a l'ouverture de la ressource pour edition, il affiche une boite de dialogue 
precisant que ces commentaires seront supprimes. 



Ajout d'une 
ressource 



Vous pouvez ajouter directement une ressource a un projet (ressource 
integree), ou l'ajouter en tant que reference a un fichier (ressource liee). 
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Ajoutd'une 
ressource integree 



Pour ajouter une ressource a votre projet , ouvrez celui-ci et suivez les 
etapes ci-dessous : 

1. Choisissez Resource I New pour afficher la boite de dialogue New 
Resource. 

2. Choisissez les fichiers en-tete dans lesquels vous souhaitez faire 
apparaitre la ressource et son identificateur. Vous pouvez choisir 
uniquement parmi les fichiers en-tete associes a votre projet ; pour 
associer un nouveau fichier en-tete a votre projet, utilisez File I Add to 
project. 

3. Double-cliquez sur le type de ressource a creer. 

■ Si vous creez un raccourci, un menu, une boite de dialogue ou une 
table de chaines, Resource Workshop place une entree pour la 
ressource dans la fenetre projet et ouvre l'editeur de ressources 
approprie. 

■ Si vous creez une ressource de donnees RC (rcdata) ou une ressource 
VERSIONINFO, Resource Workshop place une entree pour la 
ressource dans la fenetre projet, et ouvre l'editeur de texte interne. 

■ Si vous creez une ressource bitmap (icone, curseur, graphique par 
points ou police), Resource Workshop vous demande si vous voulez 
enregistrer la ressource comme texte source ou au format binaire. Pour 
integrer une ressource bitmap, selectionnez Source text. 

■ Si le type de ressource a creer n'est pas repertorie, appuyez sur le 
bouton New Type afin de creer un type defini par l'utilisateur. Pour 
plus d'informations sur les ressources definies par l'utilisateur, 
reportez-vous au chapitre 23. 



Ajoutd'une 
ressource liee 



Vous pouvez ajouter une ressource en la liant, c'est-a-dire en creant une 
reference : 

1. Choisissez File I Add to Project. Resource Workshop affiche la boite de 
dialogue Add File to Project. 
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Vous pouvez aussi 

entrer des criteres de 

recherche defichier en 

selectionnant le type du 

fichier dans la boite 

liste File Type. 



2. Tapez le nom du fichier contenant la ressource dans la boite File Name, 
ou cliquez deux fois le nom du fichier s'il est enumere dans la boite Files. 

Si le fichier n'est pas dans le repertoire actif ou si son type ne correspond 
pas au type en cours, vous pouvez le selectionner de deux manieres : 

■ Vous pouvez taper le nom et le chemin d'acces complet du fichier dans 
la boite File Name. 

■ Vous pouvez changer de repertoire en utilisant la boite liste 
Directories. Entrez ensuite vos criteres de recherche dans la boite File 
Name et appuyez sur Entree (par exemple, utilisez *.CUR pour trouver 
tous les fichiers curseur), ou selectionnez un type dans la boite liste File 
Type. Lorsque le nom de fichier desire apparait dans la boite liste Files, 
effectuez un double-clic pour selectionner le fichier. 

3. Dans la seconde liste deroulante (sous la liste deroulante File Type), vous 
voyez le fichier projet en cours, ou vous placerez tres probablement la 
reference au nouveau fichier. Si votre projet contient plusieurs 

fichiers .RC et que vous souhaitez placer la reference ailleurs, faites 
defiler la liste et trouvez le nom du fichier dans lequel vous voulez la 
placer. 

4. Appuyez sur Entree ou cliquez sur OK pour ajouter le fichier au projet. 
Dans la fenetre projet, Resource Workshop place une entree qui pointe 
sur ce fichier. 

Si vous choisissez View I By File, vous verrez le nom de fichier enumere 
et, au-dessous, le nom de la ressource. Toute modification effectuee sur 
cette ressource dans le projet est repercutee dans le fichier ressources 
d'origine. 

Pour ajouter une nouvelle ressource selon la meme methode, 

1. Dans la boite File Name de la boite de dialogue Add File to Project, 
entrez le nom du fichier a creer. Si vous n' utilisez pas l'une des 
extensions standard des fichiers de ressources (.CUR, par exemple), 
servez-vous de la boite File Type pour identifier le type de ressource 
voulu. 

2. Cliquez sur OK. Une bote de dialogue vous indique que le fichier 
n'existe pas et demande confirmation pour le creer. 

3. Cliquez sur OK pour creer le fichier. Resource Workshop insere une 
reference a ce fichier dans la fenetre projet. 
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Comment deplacer 
une ressource 



Vous pouvez deplacer des ressources d'un fichier de projet a un autre (du 
meme projet), a l'aide de Resource I Move. 

1. Selectionnez la ressource a deplacer en l'editant ou en affichant son nom 
en surbrillance dans la liste des ressources du projet. 

2. Choisissez Resource I Move. La boite de dialogue qui s'affiche contient le 
nom de cette ressource et du fichier qui la contient (signale par la 
mention "Old"). 

3. Selectionnez un fichier New (le fichier dans lequel vous souhaitez faire 
apparaitre la ressource) et cliquez sur OK 



Comment copier 
une ressource 
entre projets 



N'utilisez pas le 

raccourci Ctrl+lns, car 

lacopiene 

s'effectuerait pas de 

maniere correcte. 



Pour copier une ressource du projet actif (le projet "source") a un autre 
projet (le projet "cible"), vous disposez de deux solutions : 

■ Enregistrer la ressource sous forme de fichier, fermer le projet actif, ouvrir 
le projet cible et y ajouter la ressource. Si la ressource comporte des 
identificateurs, verifiez que ceux-ci sont conserves lors de cette operation. 

■ Ouvrir deux copies de Resource Workshop (une par projet), et utiliser le 
Presse-papiers de Windows pour copier la ressource dans le projet source 
et la coller dans le projet cible. Cette methode est plus rapide et garantit la 
conservation des identificateurs 

Pour copier une ressource par la deuxieme methode : 

1. Ouvrez deux exemplaires de Resource Workshop : l'un avec le projet 
contenant la ressource a copier (projet source), l'autre avec le projet vers 
lequel vous souhaitez la copier (projet cible). 

2. Verifiez que le projet cible contient une reference pointant sur un fichier 
d'identificateurs qui pourra recevoir les identificateurs de la nouvelle 
ressource (si necessaire, choisissez File I Add to Project et ajoutez ce 
fichier). 

3. Dans la fenetre Projet, selectionnez le projet source, puis la ressource a 
copier. Choisissez Edit I Copy pour copier la ressource dans le 
Presse-papiers. 

4. Selectionnez le projet cible, verifiez que la fenetre Project est active et 
choisissez Edit I Paste pour coller la ressource dans ce projet. Resource 
Workshop affiche la boite de dialogue Paste Resource. 
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La boite liste Paste Resource Into doit contenir le nom du projet cible. 
Verifiez que la boite liste Paste Identifiers Into affiche le nom du fichier 
qui doit recevoir les identificateurs de la ressource (si necessaire, 
deroulez la liste et selectionnez le nom de fichier approprie). Appuyez 
ensuite sur Entree ou cliquez sur OK pour coller la nouvelle ressource 
dans le projet cible. 



Comment 
supprimer une 
ressource 



Pour supprimer une ressource d'un projet, selectionnez-la dans la fenetre 
projet et choisissez Edit I Delete ou Edit I Cut (dans ce dernier cas, vous 
avez la possibilite de coller la ressource a un autre emplacement). 



Comment 
renommer une 
ressource 



Reportez-vous a la 

section "Ajout 

d'identificateurs" plus 

loin dans ce chapitre. 



Pour renommer une ressource : 

1. Choisissez Resource I Rename. Resource Workshop affiche la boite de 
dialogue Rename Resource. 

2. Dans la boite New Name, tapez le nouveau nom de la ressource et 
appuyez sur Entree. 

3. Resource Workshop vous demande si vous souhaitez creer un nouvel 
identificateur portant ce nom. 

■ Si vous cliquez sur Yes, Resource Workshop renomme la ressource et 
lui affecte la valeur d'identificateur specifiee. 

■ Si vous cliquez sur No, Resource Workshop renomme la ressource sans 
creer d'identificateur. Pour plus de details sur les avantages de la 
creation d'identificateurs, reportez-vous a la section "Comment utiliser 
les identificateurs". 



Specification des 
options de 
memoire ressource 



Resource Workshop vous permet de specifier la facon de gerer en memoire 
chaque ressource de votre projet. Cependant, si vous n'etes pas un 
programmeur Windows experiments, il est sans doute preferable de 
conserver les valeurs par defaut. 

Pour specifier les options de memoire, selectionnez la ressource dans la 
fenetre projet, puis choisissez Resource I Memory Options. La boite de 
dialogue Resource Memory Options apparait. 

Desactivez toute option de memoire non desiree (voir tableau 14.1). 

Si vous definissez les options de memoire pour une ressource Icone, ces 
options s'appliquent a toutes les images de cette ressource. 
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Void les effets de chaque option de la boite de dialogue Resource 
Memory Options : 



Tableau 14.1 

Options memoire 

des ressources 



Option 



Load on Call 



Moveable 



Discardable 



Pure 



Description 



Cette option ne charge la ressource en memoire que lorsque cette ressource 
est necessaire. Le choix de Load On Call peut reduire le temps necessaire 
pour charger votre programme. 

Si vous desactivez cette option, vous activerez Preload, ce qui signifie que 
Windows charge la ressource en memoire lors du chargement initial du 
programme. Vous ne devez precharger une ressource que si vous savez que 
Windows I'utilise des le debut de I'execution de Implication. 

Cette option permet a Windows de deplacer le segment ressource en 
memoire pour menager de la place en vue d'autres affectations de la 
memoire. 

Si vous desactivez cette option, le segment ressource occupe un bloc fixe en 
memoire. 

Permet a Windows d'eliminer le segment ressource de la memoire lorsqu'il 
n'est plus necessaire. Windows peut recharger la ressource en memoire 
lorsqu'elle redevient utile. 

Si vous desactivez cette option, vous activerez Nondiscardable. Windows ne 
pourra pas retirer le segment de la memoire pendant I'execution de 
i'application, et si I'option Pure n'est pas activee, vous pourrez modifier la 
ressource depuis votre application. Notez que Nondiscardable n'est pas 
compatible avec RC.EXE. 

Empeche la modification du segment ressource en memoire. 

Generalement, vous laissez cette option activee. Pour plus d'informations, 
reportez-vous a la documentation Windows. 
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Comment utiliser les identificateurs 



Windows requiert que chaque ressource soit associee a un nom unique ou a 
un entier unique (appele identificateur de ressource). Par defaut, Resource 
Workshop affecte un nom a chaque nouvelle ressource (par exemple, 
DIALOG_l pour une boite de dialogue ou MENU_1 pour une ressource 
menu). 

Le nom par defaut n'est pas tres descriptif, et la reference a une ressource 
seulement par son nom diminue le rendement d'une application lors de son 
execution. Pour faire face a ces limitations, vous pouvez renommer la 
ressource et lui affecter un identificateur (constante Pascal ou #define en C). 
L'emploi d'identificateurs permet d'obtenir a la fois des noms significatifs et 
un meilleur rendement a l'execution. 

■ Vous pouvez renommer la ressource en une valeur entiere. L'emploi 
d'une valeur entiere a le meme effet sur le rendement de l'application a 
l'execution que l'affectation d'un identificateur, avec le desavantage que 
l'identificateur de ressource n'est toujours pas tres descriptif. Par 
exemple, DIALOG:225 ne precise pas de quelle boite de dialogue il s'agit. 

■ Vous pouvez renommer la ressource sans creer d'identificateur. Vous 
obtenez alors une ressource avec un nom descriptif et un code plus facile a 
gerer qu'un identificateur (les parametres Windows s'attendent a un 
pointeur char de type far), mais le rendement lors de l'execution de 
l'application sera inferieur. 



Composants des 
identificateurs de 
ressource 



Un identificateur est compose de deux parties : un texte litteral (le nom 
d'identificateur) et une valeur (generalement un entier). Par exemple, 
l'instruction suivante declare un identificateur portant le nom dlg_OpenFile 
et ayant la valeur 100 : 

#define dlg_OpenFile 100 

Resource Workshop affiche cette ressource dans la fenetre projet sous le 
nom DIALOG: dlg_OpenFile, qui l'identifie comme la boite de dialogue 
Open File. 
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Les identificateurs doivent etre uniques a l'interieur d'un type de ressource. 
Seuls les 31 premiers caracteres sont significatifs (Resource Workshop 
ignore tout caractere au-dela des 31 premiers). Vous pouvez modifier la 
valeur des identificateurs dans les boites de saisie. Exemple :dans l'editeur 
Menu, vous pouvez taper l'identificateur CM_FILENEW=12 5 ; lorsque vous 
quittez la boite de saisie, Resource Workshop fait passer la valeur de 
l'identificateur CM_FILENEW a 125. 

L'affectation d'une valeur entiere a un identificateur accelere les appels a la 
ressource pendant l'execution, mais vous ne pourrez pas utiliser 
directement la valeur entiere courte (short) en tant que parametre. Vous 
devez soit transtyper l'entier en un pointeur char de type far, soit utiliser 
une macro qui realisera le transtypage a votre place. 

Si vous ecrivez votre programme en C ou en C++, vous pouvez utiliser la 
macro MAKEINTRESOURCE. Si vous ecrivez votre programme en Pascal, 
vous pouvez utiliser le type MakelntResource (un pointeur sur char). 

La macro MAKEINTRESOURCE ressemble a un appel de fonction mais 
effectue en fait un transtypage sur l'identificateur. Par exemple, pour utiliser 
dlg_OpenFile en tant que parametre dans un programme C ou C++, 
entrez-le sous la forme suivante : 

MAKEINTRESOURCE (dlg_OpenFile) 

Si vous travaillez avec un fichier .RES, un fichier executable ou un fichier 
DLL, Resource Workshop decompile tous les identificateurs de ressource de 
ce fichier en valeurs entieres. Vous ne pouvez pas ajouter des identificateurs 
a ce type de fichier, mais vous pouvez enregistrer le fichier en tant que 
fichier .RC, puis affecter des identificateurs a ses ressources. Reportez-vous 
a la section "Comment travailler avec des fichiers binaires" de ce chapitre. 



Fichiers Lorsque vous ouvrez un nouveau projet, la premiere chose a faire est de 

identificateurs specifier un fichier pour y stacker vos identificateurs. 

Stockez vos identificateurs dans un ou plusieurs fichiers en-tete (.H) qui 
utilisent des instructions #define pour affecter des valeurs aux noms 
d'identificateurs. 

Dans ce manuel, le terme fichiers identificateurs correspond aux fichiers 
en-tete, aux unites et aux fichiers inclus. 
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Creation des 

fichiers 
identificateurs 



Vous pouvez utiliser un editeur de texte ou un traitement de texte pour 
creer vos fichiers identificateurs, mais il est plus facile de laisser Resource 
Workshop le faire a votre place, comme illustre dans les paragraphes qui 
suivent et dans la section "Ajout d'identificateurs" de ce chapitre. 

Apres l'ouverture d'un nouveau projet (File I New Project) et l'affectation 
d'un nom a ce projet (File I Save Project), ajoutez le fichier identificateur en 
suivant les etapes ci-dessous : 

1. Choisissez File I Add to Project. Resource Workshop affiche la boite de 
dialogue Add File to Project. 

2. Cliquez sur le bouton /Zec/ze vers le has de la boite liste File Type pour 
afficher la liste des types de fichiers que vous pouvez ajouter a votre 
projet. 

3. Si vous ecrivez votre application en C, choisissez : 

H c header 

4. Dans la boite texte File Name, tapez le nom du fichier identificateur. 

5. Cliquez sur OK pour quitter la boite de dialogue Add File to Project. 
Resource Workshop cree le fichier identificateur. 



Fichiers en-tete C 



Si votre programme est ecrit en langage C, stockez vos identificateurs dans 
un fichier en-tete .H. Les instructions #define de ce fichier affectent des 
valeurs entieres aux noms d'identificateurs. 
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Exemple extrait d'un fichier en-tete : 

* #define selectionnes depuis RWCDEMOC . H * 



Gestion 

automatique des 
identificateurs 



#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 



bmp_StatusBar 

cm_About_CUA 

id_ClearWindow 

dlg_About 

dlg_FileNew 

sth_Edit 

men_Main 

acc_Main 

ico_RWCDemo 

sth_EditClear 

ScribbleWindow 

FileWindow 

GraphWindow 



En plus des instructions #define, vous pouvez aussi stocker des definitions 
de structure et de type, du code de programme et des commentaires dans 
un fichier en-tete. Resource Workshop ignore toutes les donnees dans le 
fichier en-tete, a l'exception des instructions #define et des directives de 
preprocesseur. 

Resource Workshop peut creer et supprimer automatiquement les 
identificateurs. Pour activer la fonction de gestion automatique des 
identificateurs, choisissez File I Preferences et cochez Generate identifiers 
automatically. Remarque : si vous utilisez AppExpert a partir de 
l'environnement EDI de Borland C++, cette case est cochee par defaut et 
indisponible (en effet, AppExpert applique systematiquement la gestion 
automatique des identificateurs). 

Lorsque la gestion automatique des identificateurs est activee, chaque fois 
que vous creez une ressource qui utilise un identificateur (par exemple, un 
element de menu), Resource Workshop definit un identificateur unique 
pour cette ressource et le place dans le fichier en-tete de cette ressource (.RH 
ou .RC). Par ailleurs, si vous supprimez une ressource, son identificateur est 
automatiquement supprime. 
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Resource Workshop affecte chaque identificateur d'un prefixe, que vous 
pouvez modifier. Le tableau ci-dessous fournit la liste des prefixes par 
defaut et indique les commandes de menu a utiliser pour les modifier (pour 
que le menu approprie soit affiche, vous devez editer le type de ressource 
correct) : 



Tableau 14.2 

Prefixes des 

identificateurs 



Ressource Prefixe Commande de menu 

Table de chaines IDS_ String Table | Change identifier prefix 

Menu CM Menu | Change identifier prefix 

Accelerateur CM Accelerator [ Change identifier prefix 

Boite de dialogue IDC Options | Change identifier prefix 



Comment travailler 
sans fichier 
d'identificateurs 



Si vous n'ajoutez pas de fichier d'identificateurs a votre projet, vous pouvez 
neanmoins creer des identificateurs pour vos ressources. Resource 
Workshop stocke ces identificateurs dans le fichier projet actif, sous forme 
d'instructions #define. 

Cette methode n'est pas conseillee pour les raisons suivantes : 

■ Si vous decidez par la suite d'utiliser un fichier d'identificateurs distinct, 
vous devrez faire appel a un editeur de texte pour couper les instructions 
#define dans les scripts de ressources et les coller dans ce fichier 
d'identificateurs. 

■ Le fichier script de ressources acceptant uniquement des instructions 
#define, vous devrez prevoir une operation d'edition supplementaire pour 
creer une unite Pascal ou un fichier de constantes. 



Ajout 
d'identificateurs 



II existe deux methodes pour ajouter des identificateurs a votre projet : 

■ En renommant votre ressource 

■ A l'aide de la boite de dialogue Identifiers 



En renommant les 
ressources 



Comme specifie a la section "Comment renommer une ressource" plus haut 
dans ce chapitre, vous pouvez renommer vos ressources a mesure que vous 
les creez. Lorsque Resource Workshop rencontre un nouveau nom de 
ressource, il vous demande automatiquement si vous desirez creer un 
identificateur pour ce nom. 
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Exemple : vous venez d'ajouter une nouvelle ressource menu a votre projet. 
Par defaut, Resource Workshop lui affecte le nom MENU_1 (ce menu est le 
premier dans le projet). Puisqu'il s'agit d'un menu fichier, vous decidez de 
le renommer en Menu_File : choisissez Resource I Rename pour afficher la 
boite de dialogue Rename Resource. 

Lorsque vous entrez un nouveau nom dans la boite de dialogue Rename 
Resource et que vous cliquez sur OK, Resource Workshop vous demande si 
vous souhaitez creer un nouvel identificateur pour ce nom. Si vous cliquez 
sur OK, Resource Workshop affiche la boite de dialogue New Identifier. 

Assurez-vous d'abord que la boite liste File contient le nom de fichier 
identificateur correct, puis tapez une valeur entiere appropriee dans la boite 
texte Value et cliquez sur OK. Lors du prochain enregistrement de votre 
projet, la valeur et le nom d'identificateur seront enregistres dans votre 
fichier .H, .PAS ou .INC. 



A partir de la boite A partir de la boite de dialogue Identifiers, vous pouvez ajouter un 

de dialogue identificateur a votre fichier d'identificateurs avant de creer la ressource qui 

Identifiers l u i es t associee : 

1. Choisissez Resource I Identifiers pour afficher la boite de dialogue 
Identifiers. 

2. Cliquez sur le bouton New. Resource Workshop affiche la boite de 
dialogue New Identifier. 

3. Utilisez la boite liste File pour specifier le fichier dans lequel 
l'identificateur sera stocke. 

4. Tapez le nom de la ressource dans la boite Name. 

5. Tapez la valeur d'identificateur dans la boite Value. 

6. Cliquez sur OK. 

Le nouveau nom de ressource apparait maintenant dans la boite liste 
Identifiers, et sa valeur est initialisee a "(unused)". 

En plus de l'ajout d'identificateurs, vous pouvez utiliser la boite de dialogue 
Identifiers pour editer,supprimer ou lister les identificateurs, et pour lancer 
un editeur de ressources. Choisissez Resource I Identifiers pour afficher la 
boite de dialogue Identifiers. 
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Edition 
d'identificateurs 



Suppression 
d'identificateurs 



Vous pouvez modifier la valeur d'un identificateur : 

1. Choisissez Resource I Identifiers pour afficher la boite de dialogue 
Identifiers. 

2. Selectionnez l'identificateur dont vous voulez modifier la valeur. 

3. Cliquez sur le bouton Change. Resource Workshop affiche la boite de 
dialogue Change Identifier Value. 

4. Tapez la nouvelle valeur dans la boite New Value et cliquez sur OK. 

La nouvelle valeur d'identificateur sera ecrite dans votre fichier .H, .PAS ou 
.INC au prochain choix de File I Save Project. 

Vous pouvez egalement deplacer et renommer des ressources a partir de la 
boite de dialogue Identifiers. 

Si un identificateur n'est pas utilise dans votre projet, il est conseille de le 
supprimer du fichier .H, .PAS ou .INC. Un identificateur peut devenir 
superflu dans l'un des cas suivants : 

■ Vous avez affecte un identificateur a une ressource, puis vous avez 
supprime cette ressource. 

■ Vous avez ajoute un identificateur au projet et ne l'avez jamais utilise. 

■ Vous avez renomme une ressource qui disposait deja d'une valeur entiere 
d'identificateur. 

Pour supprimer un identificateur : 

1. Choisissez Resource I Identifiers pour afficher la boite de dialogue 
Identifiers. 

2. Selectionnez l'identificateur a supprimer. 

Si l'identificateur selectionne n'est pas associe a une ressource (si la 
ressource a ete supprimee ou si l'identificateur n'a jamais ete utilise), la 
boite Usage indique "(unused)". 
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II est possible de 

supprimer un 

identificateur qui est 

toujours utilise. 



Cependant, si l'identificateur est toujours associe a une ressource, la boite 
Usage met automatiquement en surbrillance le type et le nom de cette 
ressource. 

3. Cliquez sur le bouton Delete. 

Si l'identificateur est inutilise, il est automatiquement supprime. Aucune 
boite de dialogue d'avertissement ne s'affiche. 

Si l'identificateur est toujours utilise, Resource Workshop affiche une 
boite de dialogue d'avertissement contenant le message "#define [or 
Constant] is used. Delete anyway?". Pour supprimer l'identificateur, 
cliquez sur le bouton Yes. Si vous ne voulez pas supprimer 
l'identificateur, cliquez sur le bouton No. 

4. Au prochain choix de File I Save Project, Resource Workshop met a jour 
le fichier identificateur, en retirant l'identificateur supprime. 



Liste des 
identificateurs 



Pour obtenir la liste des identificateurs de votre projet : 

1. Choisissez Resource I Identifiers pour afficher la boite de dialogue 
Identifiers. 

2. Effectuez votre choix entre All et Single File dans le groupe View. 

Si vous choisissez Single File, selectionnez le fichier dont vous voulez 
voir les identificateurs a partir de la boite liste File name du groupe View. 

3. Faites defiler le contenu de la boite liste Identifiers jusqu'aux 
identificateurs a visualiser. Lorsque vous mettez en surbrillance un 
identificateur dans la boite liste, son nom et sa valeur entiere 
apparaissent dans les boites Name et Value situees au-dessus de la boite 
liste. 



Lancement d'un 
editeur de 
ressources 



Vous pouvez utiliser la boite de dialogue Identifiers pour activer un editeur 
de ressources avec une ressource preselectionnee deja chargee : 

1. Faites defiler le contenu de la boite liste Identifiers jusqu'a ce que la 
ressource desiree soit en surbrillance. 

Le nom et le type de la ressource apparaissent dans la boite liste Usage. 

2. Double-cliquez sur le nom et le type en surbrillance dans la boite liste 
Usage. 

Resource Workshop lance l'editeur approprie, avec cette ressource deja 
chargee. 



Chapitre 14, Projets, ressources et identificateurs 



257 



Preferences de configuration 



Pour definir les preferences de configuration, choisissez File I Preferences. 
Pour plus d'information sur les sujets non abordes dans les paragraphes qui 
suivent, affichez l'aide en ligne en cliquant sur le bouton Help de la boite de 
dialogue Preferences. 

Undo Levels Resource Workshop comporte une fonction Undo (defaire) et Redo (refaire) 

multi-niveaux, pour corriger les actions dans les editeurs de ressources. 
Selon la quantite de memoire disponible sur votre ordinateur, vous pouvez 
defaire ou refaire jusqu'a 99 actions. Le nombre de niveaux par defaut est 10. 

Pour chaque annulation (defaire), appuyez sur Alt+Retour arriere ou choisissez 
Edit I Undo. Pour chaque retablissement (refaire), appuyez sur 
Maj+Alt+Retour arriere ou choisissez Edit I Redo. Vous pouvez avancer et 
revenir pendant la session d'edition en fonction du nombre de niveaux 
defini dans l'option Undo Levels. 

■^ Le nombre de niveaux d'annulation peut etre limite par la memoire systeme 
disponible. Une ressource necessitant beaucoup de memoire, par exemple 
un gros graphique par points avec plusieurs remplissages denses, reduit le 
nombre de niveaux d'annulation disponibles. 



Text Editor Lorsque Resource Workshop charge un fichier projet, il compile toutes les 

ressources de ce fichier. Si le compilateur decouvre une erreur, il interrompt 
la compilation, vous signale l'erreur et vous demande si vous souhaitez 
corriger le fichier avec l'editeur de texte externe specifie dans cette option. 

L'editeur de texte externe par defaut est l'editeur Notepad de Windows ; si 
vous specifiez un autre editeur, il doit tourner sous Windows (tout editeur 
DOS dote d'un fichier .PIF convient). 



Multi-Save Les preferences .RES et Executable controlent la facon dont un projet sera 

enregistre lorsque vous selectionnez File I Save Project. Ces preferences ne 
sont activees que si un projet du compilateur de ressource (.RC ou .DLG) est 
ouvert, car elles ne s'appliquent qu'a un projet specifique. Quels que soient 
les reglages de cette option, le projet est egalement enregistre dans son 
format d'origine. Par exemple, si le projet est un fichier .RC, outre les 
options de Multi-Save, les ressources du fichier sont toujours enregistrees en 
tant que scripts ressource en complement des eventuelles valeurs 
Multi-Save. 
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Target Windows 
Version 



■ .RES. Cette option compile les ressources du projet en cours et les 
enregistre au format .RES (format binaire). 

■ Executable. Cette option compile les ressources du projet en cours et les lie 
au fichier executable specif ie dans cette option (fichier .EXE ou .DLL). 

■ Make Backups When Saving Files. Si vous activez l'option Backups, Resource 
Workshop cree un jeu complementaire de fichiers de sauvegarde chaque 
fois que vous enregistrez un projet. Les fichiers de sauvegarde comportent 
un tilde (~) comme premier caractere de l'extension de fichier. Par 
exemple, si vous enregistrez MYPROJ.BMP, le fichier de sauvegarde est 
appele MYPROJ.-BM. 

Ces boutons radio vous permettent d'adapter votre ressource a des versions 
specif iques de Windows. Cependant, les fichiers .RES et .EXE adaptes pour 
Windows 3.1 ne sont pas compatibles avec Windows 3.0. 

Si le fichier .RES est adapte a Windows 3.1, vous ne pouvez pas utiliser la 
version Windows 3.0 de RC.EXE pour lier vos ressources a l'application. 
Vous devez utiliser les outils Borland ou la version 3.1 du compilateur de 
ressources Microsoft. 

Cette option est disponible uniquement si aucun projet n'est ouvert. 



Comment travailler avec des fichiers binaires 



Tous les identificateurs 

de ressource des 

fichiers binaires doivent 

etre des entiers. 



Resource Workshop vous permet d'ouvrir des fichiers executables, des 
fichiers .RES, et des fichiers DLL en tant que projets, afin de personnaliser 
leurs interfaces utilisateur. Par exemple, vous pouvez traduire l'interface de 
votre application dans une autre langue. 

Lorsque vous chargez l'un de ces fichiers, Resource Workshop decompile 
les ressources du fichier et vous les montre comme faisant partie d'un fichier 
.RC normal. Vos modifications achevees, Resource Workshop compile de 
nouveau les ressources en code binaire, et les stocke dans le fichier d'origine. 

Les ressources d'un fichier binaire decompile n'etant pas stockees au format 
script ressource, vous ne pouvez pas affecter des noms aux identificateurs 
de ressource. 

Cependant, vous pouvez enregistrer le projet en tant que fichier .RC. Les 
ressources peuvent alors etre enregistrees en tant que scripts ressource, et 
done recevoir des identificateurs. 
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Vous devez conserver 

les valeurs entieres en 

cours des 

identificateurs de 

ressource. 



Si vous personnalisez l'interface utilisateur d'un programme, et que vous 
avez acces uniquement au fichier executable ou au fichier DLL, vous pouvez 
enregistrer vos modifications dans un fichier .RC distinct, afin de les 
appliquer a la version suivante du programme. Les ressources de ce fichier 
.RC doivent avoir les memes identificateurs que leurs homologues de la 
nouvelle version, et doivent etre compatibles avec la nouvelle version. 

Lorsque vous enregistrez le projet en tant que fichier .RC, Resource 
Workshop n'enregistre pas automatiquement les ressources dans le fichier 
d'origine, sauf si vous specifiez le nom de celui-ci sous forme d'option 
Multi-Save dans la boite de dialogue Preferences. 

Pour enregistrer un fichier binaire comme un projet et ajouter des 
identificateurs, procedez comme suit : 

1. Choisissez File I Open Project et selectionnez le fichier executable, .RES 
ou DLL dans la boite de dialogue Open Project. 

2. Choisissez File I Save File As. Dans la boite de dialogue Save File As, 
selectionnez RC Resource Script dans la boite liste File Type. Entrez le 
nom du nouveau fichier .RC. 

Lorsque vous cliquez sur OK pour enregistrer le fichier, Resource 
Workshop vous place automatiquement dans le fichier .RC. 

3. Choisissez File I Preferences et entrez le nom du fichier binaire 
d'origine, en tant qu'option Multi-Save. 

■ Si le fichier binaire d'origine etait un fichier .RES, activez .RES et entrez 
le nom dans cette boite texte. 

■ Si le fichier binaire d'origine etait un fichier executable, ou .DLL, 
activez Executable et entrez le nom dans cette boite texte. 

4. Choisissez File I Add to Project et specifiez un fichier identificateur pour 
contenir les nouveaux identificateurs. Si le fichier que vous specifiez 
n'existe pas, Resource Workshop le cree. 

5. Modifiez les ressources et specifiez des identificateurs aux endroits 
souhaites. Pour chaque nouvel identificateur, Resource Workshop vous 
demande si vous voulez l'enregistrer dans le fichier identificateur. 

6. Lorsque vous quittez et enregistrez le fichier, Resource Workshop 
enregistre le fichier .RC et le fichier binaire. Si ce dernier est un fichier 
executable, ou DLL, les ressources modifiees lui sont liees (et sont 
immediatement disponibles lorsque vous executez ce programme). 
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Comment creer des ressources 32 bits 



Par defaut, Resource Workshop cree des ressources 16 bits si vous travaillez 
sous Windows en mode 16 bits et des ressources 32 bits si vous utilisez 
Windows NT, mais vous pouvez creer des ressources 32 bits dans le premier 
cas et des ressources 16 bits dans le deuxieme cas. 

Pour changer le type des ressource creees, fermez tous les projets ouverts et 
procedez comme suit : 

1. Choisissez File I Preferences. 

2. Cochez l'option Target Windows Version requise et cliquez sur OK. 

3. Choisissez File I New project. Lorsque vous avez commence a creer un 
projet, vous ne pouvez modifier le type de Target (par exemple, vous ne 
pouvez pas passer de Win32 a Windows 3.1). 

Si vous choisissez le type de Target Win32, vous pouvez egalement choisir 
une langue majeure et une langue mineure dans la boite de dialogue 
File I Preferences (dans ce cas, la langue choisie doit etre la langue qui sera 
utilisee sous NT ; sinon, l'affichage des ressources - et plus particulierement 
des menus - risque d'etre incorrect). 
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Creation de boites de dialogue 



Les boites de dialogue sont des fenetres surgissantes qui permettent de choisir 
diverses options d'un programme (fichiers a ouvrir, couleurs a afficher, 
texte a rechercher, etc.). 

Une boite de dialogue contient generalement un certain nombre de controles 
(boutons, boites texte et barres de defilement) permettant de specifier les 
informations requises, ou d'afficher un texte et des graphiques statiques 
dans la boite de dialogue. 



Figure 15.1 

Exemple de boite de 

dialogue 






Square 

Circle 

Triangle 



Cases a cocher Barre de titre 




| Cancel^] | Help ] 



-Boutons radio Boutons poussoirs 



Lancement de I'editeur Dialog 



Avec I'editeur Dialog, vous pouvez creer des boites de dialogue, ou editer 
des boites de dialogue existantes. Vous lancerez I'editeur Dialog 
differemment selon la tache a realiser. 



Creation d'une 
boite de dialogue 

Le chapitre 14 decrit la 

procedure d'ouverture 

d'unprojet. 



Pour lancer I'editeur Dialog et creer une boite de dialogue : 

1. Choisissez File I New Project pour lancer un nouveau projet, ou File I 
Open Project pour charger un projet existant. 

2. Choisissez Resource I New. La boite de dialogue New Resource s'affiche. 

3. Dans la boite liste Resource Type, double-cliquez sur DIALOG. 
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4. Une autre boite de dialogue s'affiche pour vous permettre de specifier un 
modele (type) de boite de dialogue ; choisissez un type et cliquez sur OK. 

5. Vous etes maintenant dans l'editeur Dialog, qui affiche le gabarit de boite de 
dialogue choisi. La figure 15.2 illustre les composants de l'editeur Dialog. 



Figure 15.2 Barre menu 
Editeur Dialog avec 
boite de dialogue 
vide 



E— CBBSHlia 

File Edi1 N Resource Control Align Options Window Help 



i.im.u.iMi.iJi 




Barre Alignment 




Modele de boite de 
dialogue vide 



Palette Tools 



|M odrfy 



Barre d'etat 



Edition dune boite 
de dialogue 
existante 



Pour editer une boite de dialogue qui existe deja dans un fichier projet : 

1. Ouvrez le projet qui contient la boite de dialogue a editer. 

2. Retrouvez la boite de dialogue a editer dans la fenetre projet et 
double-cliquez sur son nom. 

L'editeur Dialog s'ouvre. II ressemble a la figure 15-2, a ceci pres que la boite 
de dialogue selectionnee apparait a la place de la boite de dialogue vide. 
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Utilisation de I'editeur Dialog 



Comme illustre a la figure 15.2, I'editeur Dialog vous presente un modele 
vide lorsque vous creez une boite de dialogue. Vous pouvez choisir le type 
de fenetre de votre boite de dialogue, un libelle, les polices a afficher, etc. 
Vous pouvez aussi ajouter, modifier, grouper, reordonner, deplacer, 
redimensionner ou supprimer des controles dialogue, afin que votre boite 
de dialogue fonctionne comme vous le souhaitez. 



Selection d'une 
boite de dialogue 



Definition des 
attributs d'une 
boite de dialogue 



Pour modifier la fenetre de la boite de dialogue, ou pour definir les attributs 
d'une boite de dialogue, vous devez d'abord la selectionner. Pour cela, 
cliquez sur la barre de titre ou sur le bord externe de la boite de dialogue 
requise. 

Lorsqu'une boite de dialogue est selectionnee, Resource Workshop l'entoure 
d'un cadre de selection. Vous pouvez alors : 

■ Deplacer la boite de dialogue a l'aide de la souris ou des touches flechees. 

■ Redimensionner la boite de dialogue selon l'une des procedures suivantes : 

• Faites glisser le bord ou le coin approprie. 

• Selectionnez la boite de dialogue en cliquant sur sa barre de titre, puis en 
choisissant Align I Size pour afficher la boite de dialogue Size Dialog. 
Entrez les valeurs de largeur (CX) et de hauteur (CY) en unites dialogue. 
Dans une unite dialogue, Y correspond a 1/8 de la hauteur de police, et X 
correspond a 1/4 de la largeur de police. (Ces valeurs s'appliquent aux 
dimensions exterieures de la boite de dialogue.) 

Au moyen de la boite de dialogue Window Style, vous pouvez definir les 
attributs suivants de votre nouvelle boite de dialogue : 

■ Libelle, classe et menu 

■ Type de fenetre 

■ Style de cadre 

■ Style de dialogue 

■ Police 

Pour afficher la boite de dialogue Window Style, selectionnez la boite de 
dialogue dont vous souhaitez definir les attributs et appuyez sur Entree, ou 
double-cliquez avec l'outil de selection (le pointeur de la souris se change en 
fleche) sur la barre de titre de la barre de dialogue. 
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Ajout d'un libelle 

Pour modifier un libelle, 

vous pouvez egalement 

utiliser la boite 

Properties (choisissez 

Options I Show 

Properties) 



Pour ajouter un libelle : 

1. Double-cliquez sur la barre de titre de la boite de dialogue pour ouvrir la 
boite de dialogue Window Style. 

2. Tapez le nouveau nom de votre boite de dialogue dans la boite de saisie 
Caption. 

3. Au-dessous de Frame Style, veillez a ce que Caption (la valeur par 
defaut) soit selectionnee. 

4. Cliquez sur OK. 

La boite de dialogue Window Style permet de choisir l'un des types suivants 
pour votre boite de dialogue : 

■ Popup. Fenetre surgissante (valeur par defaut, dans la mesure ou la 
plupart des boites de dialogue sont de ce type). 

■ Child. Enfant de la fenetre active. 

■ Overlapped. Fenetre surgissante qui peut etre recouverte (integralement ou 
partiellement) par une autre. Pour etre de ce type, une boite de dialogue 
doit etre la fenetre principale de l'application. 



Selection d'un 
style de cadre 



Le style du cadre de la boite de dialogue determine l'aspect du cadre et de la 
barre titre en haut de la boite de dialogue. 

Choisissez un style de boite de dialogue a partir de la boite de dialogue 
Window Style. Les options disponibles sont les suivantes : 

■ Dialog Frame. Une double bordure, sans barre de titre. 

■ Border. Une seule bordure fine, sans barre de titre. 

■ Caption. Une seule bordure fine et une barre de titre ou un libelle pourra 
s'afficher (par defaut). 

■ No Border. Pas de bordure ni de barre de titre. 



Specification du 
style de dialogue 



Le style de dialogue determine l'aspect de la boite de dialogue et son type 
d'utilisation. Les options disponibles sont les suivantes : 

■ System Menu. Integre une case de menu Systeme a gauche de la barre de 
titre. Egalement appele menu Control, le menu Systeme s'affiche 
uniquement si vous avez choisi Caption comme style de cadre pour votre 
boite de dialogue (Caption et System Menu sont deux valeurs par defaut). 
Si la boite de dialogue est definie comme une fenetre enfant, vous 
obtiendrez une case Fermeture au lieu d'un menu Control. 
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Thick Frame. Tracage d'un cadre epais autour de la boite de dialogue. Cette 
option definit ce que l'utilisateur verra lorsque la boite de dialogue va 
s'afficher dans une application. Si vous souhaitez une boite de dialogue 
redimensionnable, utilisez cette option. 

Ne confondez pas cette option avec l'option Thick Frame de la commande 
Preferences de l'editeur Dialog, qui definit l'aspect de la boite de dialogue 
si vous la selectionnez dans l'editeur Dialog. 

Vertical Scroll. Ajout d'une barre de defilement verticale dans le cadre de la 
boite de dialogue. 

Horizontal Scroll. Ajout d'une barre de defilement horizontale dans le cadre 
de la boite de dialogue. 

Minimize Box. Ajout d'un bouton Reduction a droite de la barre de titre. Ce 
bouton s'affiche uniquement si vous avez selectionne Caption comme 
style de cadre pour votre boite de dialogue. 

Maximize Box. Ajout d'un bouton Maximize a droite de la barre de titre. Ce 
bouton s'affiche uniquement si vous avez selectionne l'option Caption 
comme style de cadre pour votre boite de dialogue. 

Absolute Align. Les coordonnees de la boite de dialogue deviennent 
proportionnelles a l'ecran plutot qu'a la fenetre parent. 

System Modal. La boite de dialogue devient modale par rapport au 
systeme, ce qui signifie que l'utilisateur ne peut passer a une autre action 
tant que la boite de dialogue est affichee. 

Local Edit. Alloue tous les controles d'edition de texte inclus dans cette 
boite de dialogue au segment de memoire local de l'application. 

Choisissez Local Edit si votre application doit utiliser les messages 
EM_SETHANDLE et EM_GETHANDLE. 

Modal Frame. Encadre la fenetre avec une combinaison de styles 
d'encadrement et de libelle (valeur par defaut). Choisissez Modal Frame si 
vous souhaitez que les utilisateurs puissent deplacer la boite de dialogue. 

No Idle Messages. Supprime la transmission des messages 
WM_ENTERIDLE a la fenetre principale de l'application. Cette option est 
possible uniquement avec les boites de dialogue modales. 
Clip Children. Protege la zone client des fenetres enfant. 

Clip Siblings. Protege les soeurs de la fenetre. L'affichage est limite a cette 
fenetre. Cette option n'est pas necessaire pour les fenetres surgissantes, 
mais elle peut etre utile pour les fenetres de dialogue enfant. 
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Selection de police 



Comment inclure 
un menu 



■ Visible. Rend visible une boite de dialogue non modale avant le retour de 
CreateDialog. Cette option n'a aucun effet sur les boites de dialogue 
modales (le type de boite de dialogue le plus courant). Par defaut, cette 
option est desactivee (NOT WS_VISIBLE). 

Par defaut, les boites de dialogue utilisent la police MS Sans Serif 8 points 
pour le texte, mais vous pouvez choisir une police et une taille differentes : 

1. Ouvrez la boite de dialogue Window Style. 

2. Cliquez sur le bouton Fonts pour ouvrir la boite de dialogue Select Font. 

3. Utilisez la boite de dialogue Select Font pour choisir une police et une 
taille de caractere pour le texte de votre boite de dialogue. Les caracteres 
de la boite Text situee en bas de la boite de dialogue illustrent la police et 
la taille de caractere actuellement selectionnee. (Notez que Windows 
accepte uniquement du texte en gras dans les boites de dialogue.) 

Une boite de dialogue peut inclure un menu puisqu'elle est en fait une 
fenetre. Par exemple, certaines applications utilisent une boite de dialogue 
pour leur fenetre principale. Dans ce cas, la boite de dialogue necessite un 
menu. 

Pour inclure un menu dans votre boite de dialogue : 

1. Creez le menu comme une ressource separee et verifiez qu'il fait partie 
du projet (voir le chapitre 16). Notez le nom de la ressource ou 
l'identificateur numerique qui designe le menu. 

2. Ouvrez l'editeur Dialog et chargez la boite de dialogue dans laquelle 
vous voulez ajouter le menu. 

3. Ouvrez la boite de dialogue Window Style. 

4. Dans la boite de saisie Menu, tapez le nom de ressource ou 
l'identificateur numerique du menu. 

Dans les modes d'affichage standard, l'editeur Dialog n'affiche pas le menu. 
Lorsque vous testez la boite de dialogue (voir la section "Comment tester 
une boite de dialogue" de ce chapitre), Resource Workshop affiche le menu 
generique "Menu" qui ne contient qu'un seul element de menu : "Item". 
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Comment affecter 
une classe 
personnalisee a 
une boite de 
dialogue. 



Si vous etes un programmeur Windows confirme, vous souhaiterez 
peut-etre affecter une classe personnalisee a une boite de dialogue, afin de 
gerer les messages de la boite de dialogue avec vos propres procedures de 
fenetres (au lieu des procedures Windows). Vous pouvez aussi affecter une 
classe personnalisee a une boite de dialogue pour la transformer en boite de 
dialogue de style Borland. 

Pour affecter une classe personnalisee a une boite de dialogue : 

1. Ouvrez la boite de dialogue Window Style. 

2. Tapez le nom de la classe dans la boite de saisie Class. 



Definition de la 
position de la boite 
de dialogue 



Si votre boite de dialogue utilise le style WS_OVERLAPPED, vous pouvez 
laisser Windows la positionner a l'ecran. Cette option est generalement 
utilisee pour les boites de dialogue qui jouent le role de fenetres principale. 
Pour dormer le controle de la position de la boite de dialogue a Windows : 

1. Selectionnez le cadre de la boite de dialogue en cliquant sur son bord ou 
sur la barre de titre. 

2. Choisissez Align I Size. 

3. Dans la boite de dialogue Size Dialog, cliquez sur le bouton radio Set By 
Windows. 

Resource Workshop noircit la valeur de coordonnee X dans la boite de 
dialogue, specifiant ainsi que Windows a le controle de la boite de 
dialogue. 

4. Cliquez sur OK pour quitter la boite de dialogue Size Controls. 



Comment travailler 
avec les controles 



Les controles sont des composants individuels des boites de dialogue. lis 
permettent l'echange d'informations entre l'utilisateur et l'application, et 
appartiennent aux categories suivantes : 

■ Boutons 

■ Barres de defilement 

■ Boites liste 

■ Boites de saisie 

■ Controles statiques 

■ Boites a options combinees 

■ Controles personnalises 
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Families de 
controles 



Palette Tools 



Chaque controle utilise provient d'un des cinq groupes de famille suivants : 

■ Controles Windows standard tels que les boutons-poussoirs, les cases a 
cocher, les boites liste et les boutons radio. Les icones des controles 
Windows standard apparaissent dans les deuxieme et troisieme colonnes 
de la palette Tools. Ces controles sont toujours disponibles. 

■ Borland Windows Custom Controls (BWCC), toujours disponibles. Les 
Controles Personnalises Windows de Borland (y compris les boutons 
radio, les cases a cocher et les boutons-poussoirs) offrent des ameliorations 
fonctionnelles et visuelles par rapport aux controles Windows standard. 
Les icones de ces controles apparaissent dans la quatrieme colonne de la 
palette Tools et sont decrits dans l'annexe B. 

■ Controles personnalises dont la classe est reconnue par Resource 
Workshop. Ces controles sont stockes dans un fichier DLL qui inclut la 
fonction ListClasses. Lorsque le fichier DLL est installe, les icones de ces 
controles apparaissent dans une ou plusieurs colonnes supplementaires 
de la palette Tools, en commencant a droite des icones BWCC. Ce type de 
controle est decrit a la section "Controles personnalises" de ce chapitre, et 
dans le fichier CUSTCNTL.RW. 

■ Controles personnalises dont la classe est reconnue par l'editeur de 
dialogues du SDK de Windows. Ces controles sont stockes dans un fichier 
DLL qui inclut leurs bitmaps mais non la fonction ListClasses. lis ne sont 
pas representees dans la palette Tools, mais leur nom apparait dans la liste 
deroulante de la boite de dialogue New Custom Control (voir la section 
"Controles personnalises" de ce chapitre). Lorsque vous ajoutez un de ces 
controles dans une boite de dialogue, son bitmap apparait a l'ecran si 
Resource Workshop est en mode d'affichage WYSIWYG. 

■ Controles personnalises dont la classe n'est pas reconnue par Resource 
Workshop ni par l'editeur de dialogues du SDK de Windows. Resource 
Workshop ajoute leurs noms dans la liste deroulante de la boite de 
dialogue New Custom Control, mais ils apparaissent a l'ecran (en mode 
WYSIWYG) sous forme de rectangles gris. 

La colonne gauche de la palette Tools contient des outils qui definissent le 
mode d'exploitation en cours de l'editeur Dialog. 

Les autres colonnes contiennent des icones pour les controles Windows 
standard, pour les controles BWCC et pour tous les controles personnalises 
charges et reconnus par Resource Workshop. 
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Figure 15.3 
Palette Tools 
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Void une breve description des controles Windows standard dont les icones 
apparaissent dans les deuxieme et troisieme colonnes de la palette Tools. 

Bouton-poussoir Bouton rectangulaire sur lequel l'utilisateur "appuie" 
pour selectionner une action. Puisque les 
boutons-poussoirs contiennent toujours un texte, vous 
devez indiquer un titre pour chacun d'entre eux. 

Bouton radio Bouton circulaire avec un texte a sa gauche ou a sa 

droite. Lorsque le bouton est selectionne, un point 
apparait dans le cercle. Les boutons radio s'utilisent en 
groupe pour representer une serie d'options qui 
s'excluent mutuellement. 



Mil 



Barre de 

defilement 

horizontal 



Rectangle horizontal avec fleche directionnelle a chaque 
extremite. 
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Barre de 

defilement 

vertical 

Boite liste 



Rectangle vertical avec fleche directionnelle a chaque 
extremite. 

Rectangle contenant generalement une liste de chaines 
de texte. Si vous utilisez le style Owner-draw, la boite 
liste peut ainsi contenir une representation visuelle 
d'une liste de donnees. En general, l'utilisateur peut faire 
defiler le contenu de la liste et choisi un ou plusieurs 
elements. Les boites listes se rencontrent frequemment 
dans les boites de dialogue Ouvrir fichier. 



El 



Case a cocher Bouton rectangulaire avec un texte a sa gauche ou a sa 

droite. Si vous selectionnez une case a cocher, elle est 
marquee d'un X. Lorsqu'elle n'est pas selectionnee, le 
carre est vide, les cases a cocher s'utilisent en general 
pour representer l'etat booleen (active /desactive) d'une 
option. 
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Boite groupe 



Boite a options 
combinees 



Boite rectangulaire utilisee pour regrouper visuellement 
plusieurs controles. Vous pouvez inclure un libelle a 
afficher dans Tangle superieur gauche de la boite groupe. 

Combinaison d'une boite liste et d'un controle edition 
texte, ou d'une boite liste et d'un controle statique. 



T 



□ 



Controle 
edition texte 

Controle 
statique texte 



Rectangle dans lequel l'utilisateur peut entrer du texte a 
partir du clavier. 

Texte qui s'affiche dans la boite de dialogue. 



Controle statique Icone. 
en forme d'icone 



Controle statique Cadre vide rectangulaire de la couleur du cadre de la 
a cadre noir fenetre active. 
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G55P 



Rectangle noir Icone controle statique qui apparait sous la forme d'un 
rectangle de la couleur du cadre de la fenetre active. 

Controle Controle dont la classe est differente des types BWCC ou 

personnalise Windows standard, non reconnu par Resource 

Workshop. 



Selection de 
controles 



Lk 



Un certain nombre d'options d'edition Resource Workshop necessitent 
qu'un ou plusieurs controles soient selectionnes. Par exemple, vous devez 
selectionner un controle avant de pouvoir modifier sa taille, et vous devez 
selectionner au moins deux controles avant de pouvoir les aligner l'un par 
rapport a l'autre. Tout controle selectionne est entoure par un cadre de 
selection. 

Pour basculer en mode selection afin de pouvoir selectionner les controles, 
vous devez d'abord cliquer sur l'outil Selecteur (le pointeur de la souris se 
change en fleche). 

Pour selectionner un seul controle, placez le Selecteur a l'interieur du 
controle ou sur son bord, selon l'etat courant de la case a cocher Select Near 
Border dans la boite de dialogue Options I Preferences et cliquez. 

Pour selectionner plusieurs controles, vous disposez de deux options : 

■ Faites glisser un rectangle de selection autour des controles a selectionner, 
en suivant les etapes ci-dessous : 

IChoisissez l'outil Selecteur. 

2. Cliquez sur un des controles pour garantir que le controle (et non la boite 
de dialogue entiere) est selectionne. 

3. Faites glisser un rectangle de selection. Selon l'etat courant de la case a 
cocher Selection Rectangle Surrounds de la boite de dialogue 
Options I Preferences, le rectangle de selection doit entourer 
completement les controles, ou simplement les toucher. 

Resource Workshop place un cadre de selection autour des controles 
selectionnes. Pour deplacer les controles selectionnes, faites glisser le 
cadre de selection. 

■ Vous pouvez effectuer un Maj-clic pour selectionner certains controles, et 
non l'ensemble des controles comme le ferait la methode precedente. Pour 
effectuer un Maj-clic, cliquez sur le premier controle, puis maintenez 
enfoncee la touche Maj pendant que vous cliquez sur les autres controles a 
selectionner. 
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Pour afficher la 

sequence, cliquez sur 

I'outil Set Order. 



Ajout de controles 



Pour ajouter un ou plusieurs controles a un groupe deja selectionne, ou 
supprimer un ou plusieurs controles de ce groupe, effectuez un Maj-clic sur 
les controles a ajouter ou a supprimer. 

Pour selectionner tous les controles d'une boite de dialogue, choisissez 
Edit I Select All. Resource Workshop place un cadre autour de chaque 
controle, et un cadre de selection autour du groupe ainsi constitue. Notez 
que Edit I Select All ne selectionne pas le cadre de la fenetre contenant la 
boite de dialogue. 

Vous pouvez aussi selectionner les controles au moyen de la touche Tab : 

■ Si un seul controle est selectionne, l'appui sur Tab deplace la selection sur 
le prochain controle dans la sequence (ordre dans lequel les controles ont 
ete ajoutes). L'appui sur Maj-Tab ramene la selection sur le controle 
precedent dans la sequence. 

Dans tous les cas, si le controle selectionne est le dernier de la sequence, 
Tab deplace la selection sur le cadre de la boite de dialogue. 

■ Si vous avez selectionne un groupe de controles a l'aide du rectangle de 
selection, Tab deplace la selection sur le prochain controle dans la 
sequence, apres le controle le plus eleve du groupe. 

Par exemple, si le rectangle de selection contient les controles 4, 5, 9 et 10, 
Tab deplace la selection sur le controle 11 (s'il existe). 

■ Si vous avez selectionne un groupe de controles a l'aide de Maj-clic, Tab 
deplace la selection sur le premier controle de la sequence qui suit le 
dernier controle selectionne. 

Par exemple, si les controles selectionnes dans un groupe sont 9, 10, 4 et 5 
dans cet ordre, Tab deplace la selection sur le controle 6. 

La maniere la plus simple d'ajouter un nouveau controle a votre boite de 
dialogue est la suivante : 

1. Cliquez sur le controle souhaite dans la palette Tools. Le pointeur se 
transforme pour indiquer le type de controle que vous allez installer. 

2. Cliquez a l'endroit ou vous souhaitez positionner le controle dans la 
boite de dialogue. 

Si vous selectionnez un controle dans la palette Tools mais que vous 
souhaitez modifier son emplacement, choisissez I'outil Selecteur. Le 
pointeur redevient une fleche, ce qui vous permet de selectionner les 
controles dans votre boite de dialogue. L'appui sur Echap avant de placer un 
controle vous renvoie au mode de selection. 
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Vous pouvez aussi utiliser le menu Control de l'editeur Dialog (dans la 
barre menu, et non la bordure de fenetre) pour ajouter des controles a votre 
boite de dialogue : 

1. Utilisez la souris ou appuyez sur Alt+C pour ouvrir le menu Control. 

2. Choisissez le type de controle a ajouter dans votre boite de dialogue. 

3. Cliquez sur la boite de dialogue a l'endroit ou vous souhaitez placer le 
controle. 



Ajout de plusieurs 
copies dun 
controle 



a 



+D 



Vous pouvez egalement placer plusieurs copies identiques d'un controle en 
rangees ou colonnes. Vous souhaitez, par exemple, placer deux colonnes de 
quatre cases a cocher dans votre boite de dialogue. Vous pourriez 
positionner chaque case a cocher separement, mais Resource Workshop 
vous propose une solution plus simple grace a la commande EditDuplicate. 

Pour placer plusieurs copies identiques d'un controle en rangees ou en 
colonnes : 

1. Dans votre boite de dialogue, selectionnez le controle a copier. 

2. Cliquez sur l'outil Duplicate ou choisissez EditDuplicate. La boite de 
dialogue Duplicate Control s'affiche. 

3. Indiquez le nombre de rangees et colonnes souhaite, ainsi que 
l'espacement d'unites dialogue entre ces rangees et colonnes. 

Si vous souhaitez, par exemple, placer huit cases a cocher en deux 
colonnes, indiquez quatre rangees et deux colonnes. 

4. Choisissez OK. Les copies du controle s'affichent dans la boite de 
dialogue, alignees a intervalles reguliers. 

Lorsqu'un seul controle est selectionne, l'outil Duplicate a le meme effet que 
Edit Duplicate. Avec plusieurs controles selectionnes, cet outil a le meme 
effet que Align I Array (voir la section "Comment disposer les controles en 
colonnes et rangees" de ce chapitre). 



Proprietes des 
controles 
(controles .VBX) 



Pour afficher les proprietes des controles que vous ajoutez dans les boites de 
dialogue, choisissez Options I Show Properties. Lorsque Show Properties 
est activee, la boite de dialogue Properties s'affiche (elle contient les 
proprietes du controle selectionne). 

Les controles .VBX peuvent etre modifies uniquement a partir de la boite de 
dialogue Properties. 
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Si la boite de dialogue Properties n'est pas affichee, vous pouvez 
double-cliquer sur le controle .VBX requis pour en afficher directement les 
proprietes. 



Deplacement des 
controles 



Vous pouvez deplacer un controle selectionne en le faisant glisser a partir de 
n'importe quelle position a l'interieur de son cadre de selection. Vous 
pouvez aussi deplacer des controles groupes de la meme facon. lis se 
deplacent ensemble, en conservant leur position relative entre eux. 

Pour deplacer un controle a l'aide du clavier, appuyez sur Tab pour 
selectionner le controle. Utilisez ensuite les touches flechees pour deplacer le 
controle et appuyez sur Entree pour valider. Si vous changez d'avis, appuyez 
sur Echap au lieu de Entree. 



Redimensionnement 
des controles 



Les unites dialogue 

sont definies a la 

section "Selection 

d'une boite de 

dialogue". 



Vous pouvez modifier la taille d'un controle selectionne en faisant glisser le 
bord ou Tangle approprie. Vous pouvez utiliser a la fois le clavier et la 
souris pour affiner la taille : 

1. Selectionnez le controle et deplacez le curseur de la souris sur la partie 
du bord appropriee. 

2. Lorsque le curseur devient une fleche double, maintenez enfonce le 
bouton gauche de la souris. 

3. Appuyez sur la touche flechee appropriee pour deplacer le curseur de la 
souris et le cadre de selection. Chaque appui sur la fleche deplace le 
curseur d'une seule unite dialogue. 



Placement et 
dimensionnement 
des controles en 
une seule operation 



A l'aide de la boite de dialogue Size Controls, vous pouvez specifier 
simultanement la position et la taille d'un controle. 

1. Selectionnez le controle souhaite. 

2. Choisissez Align I Size ou maintenez la touche Menfoncee tout en 
double-cliquant. La boite de dialogue Size Controls s'affiche. 

3. Pour definir la position de Tangle superieur gauche du controle, specifiez 
ses coordonnees X et Y en unites dialogue. Les coordonnees 0,0 placent le 
controle dans Tangle superieur gauche de la fenetre boite de dialogue, 
directement sous la barre de titre. 

Pour definir la hauteur et la largeur du controle, specifiez ses valeurs CX 
et CY en unites dialogue (voir la figure suivante). 
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Figure 15.4 

Coordonnees d'une 

boite de dialogue 



x,y 



ex 



cy 



Alignement des 
controles avec une 
grille 



Edition de 
controles 



Vous pouvez afficher une grille sur votre boite de dialogue et l'utiliser pour 
aligner vos controles : 

1. Choisissez Align I Grid. La boite de dialogue Set Grid Attributes 
s'affiche. 

2. Specifiez la largeur et la hauteur d'une cellule de grille (en unites 
dialogue). 

3. Selectionnez le type de grille. Void les options disponibles : 

■ Absolute. Deplace le controle jusqu'a la ligne de grille la plus proche. 

■ Relative. Deplace le controle uniquement par increments de largeur de 
grille (horizontalement) et de hauteur de grille (verticalement). Ainsi, si 
le controle n'a pas ete place initialement sur une ligne de la grille, vous 
ne pourrez pas le deplacer jusque sur une ligne lorsque cette option est 
selectionnee. 

Exemple : avec une grille reglee a 4x4 et un controle place en (1,1)/ 
lorsque vous deplacez le controle, il se positionnera quatre unites plus 
loin dans chacun des axes. Les coordonnees possibles seraient (5,5), 
(5,9), (9,5), etc. 

4. Cochez l'option Show Grid et choisissez OK. 

Pour modifier un controle dans votre boite de dialogue, double-cliquez sur 
le controle pour afficher sa boite de dialogue Style. Les options de cette boite 
de dialogue varient selon le type de controle avec lequel vous travaillez. Par 
exemple, double-cliquer sur un bouton amene la boite de dialogue Button 
Style. 

Avec le clavier, utilisez Tab pour selectionner le controle a editer. Appuyez 
sur Entree pour afficher la boite de dialogue Style du controle selectionne. 
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Bien que chaque type de controle dispose de sa propre boite de dialogue 
Style, ces boites de dialogue ont de nombreuses options en commun (voir 
tableau ci-apres). 



Tableau 15.1 

Options communes 

aux boites de 

dialogue Style 



Option 

Caption 



Control ID 



Scroll Bar 



Description 

Vous permet d'entrer le libelle qui s'affichera avec le controle. Differents 
types de controles affichent des libelles dans differentes zones. Par exemple, 
dans une boite groupe, le libelle s'affiche en haut a gauche. Sur un 
bouton-poussoir, le libelle s'affiche a I'interieur du bouton. 

Certains controles n'affichent pas de libelle. Par exemple, une boite liste 
n'affiche pas le texte specifie dans son libelle. 

A droite de I'endroit ou vous saisissez le libelle, verifiez I'option Text ou 
Number. Choisissez Text si vous voulez entourer le libelle avec des 
guillemets dans le code source du fichier dialogue ou du fichier .RC. 
Selectionnez Number si vous ne voulez pas de guillemets. 

Permet de designer un identificateur unique pour le controle. Les 
identificateurs de controle peuvent etre un nombre entier ou une expression 
entiere. Tapez I'identificateur de controle que vous souhaitez affecter a ce 
controle. 

Par convention, les controles statiques qui ne sont pas modifies au moment 
de I'execution regoivent I'identificateur de controle -1 . 

Si vous tapez un identificateur de controle alphanumerique, Resource 
Workshop verifie si un identificateur existe en tant que #define ou declaration 
de constante. Resource Workshop vous demande si vous souhaitez creer un 
identificateur. Voir le chapitre 14 pour plus d'informations sur les 
identificateurs. 

Vous permet de choisir si vous souhaitez associer des barres de defilement 
verticales ou horizontales a votre controle. 
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Tableau 15.2 
Attributs de controle 



Certains attributs sont communs a la plupart des controles 



Attribut 



Description 



Tab Stop Permet a I'utilisateur d'appuyer sur Tab pour acceder au controle. 

Group Identifie le premier controle d'un groupe. Voir la section "Regroupement de 

controles lies" de ce chapitre pour plus de details sur le regroupement des 
controles et I'acces aux controles. 

Visible Determine si le controle est visible lors de I'affichage de la boite de dialogue. 

Par defaut, cette option est activee (WS_VISIBLE). Si ce n'est pas le cas 
(NOT WS_VISIBLE), le controle n'apparait pas. L'application peut appeler la 
fonction ShowWindow au moment de I'execution pour afficher le controle. 

Disabled Estompe (affiche en grise) le controle pour indiquer qu'il ne repondra pas a 

I'entree utilisateur. 

Border Trace une bordure autour du controle. 



Comment ajouter 
des libelles aux 
controles 



Chaque type de boite de dialogue Style comporte des options specifiques a 
un type de controle particulier. Ces options sont repertoriees a partir de la 
section "Controles boutons" de ce chapitre. 

Pour ajouter un libelle a un controle, vous pouvez utiliser la boite de 
dialogue Style, mais aussi la boite de dialogue Properties ; selectionnez le 
controle a completer et suivez l'une des methodes ci-dessous : 

■ Choisissez Options I Show properties et tapez un libelle dans la boite de 
saisie superieure. 

■ Double-cliquez sur le controle (dans la boite de dialogue) et tapez son 
libelle dans la boite de saisie Caption. 



Modification d'une 
classe de controle 



Pour plus 

d'informations sur les 

controles 

personnalises, voir la 

section "Controles 

personnalises" de ce 

chapitre. 



Si vous travaillez avec des controles personnalises, la boite de dialogue 
Generic Control Style vous sera utile. Affichez-la en maintenant la touche 
Ctrl enfoncee et en double-cliquant sur votre controle. Vous pouvez aussi 
utiliser Tab pour selectionner le controle, puis maintenir la touche Ctrl 
enfoncee et appuyer sur Entree. 

Dans la boite de dialogue Generic Control Style, vous pouvez modifier la 
classe d'un controle. Vous pouvez aussi specifier un libelle, un identificateur 
de controle et un style. Si vous tapez d'autres informations a cote de Info, la 
boite de dialogue ne sera pas compatible avec le compilateur de ressources 
(Resource Compiler) Microsoft. 
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Comment definir 
des controles 
comme taquets de 
tabulation 



Les outils Tab Set, Set 

Groups et Set Order 

affectent I'interaction 

clavier de I'utilisateur 

avec la boite de 

dialogue. 



m 



Avec le clavier, les utilisateurs appuient generalement sur la touche Tab 
pour deplacer le pointeur d'un controle (ou groupe de controles) a un autre. 
Certains types de controles sont automatiquement definis comme taquets de 
tabulation lors de leur ajout dans une boite de dialogue. En definissant l'etat 
"taquet de tabulation" d'un controle, vous pouvez gerer les deplacements de 
I'utilisateur a l'interieur de la boite de dialogue au moyen de la touche Tab. 

Deux methodes permettent de modifier les taquets de tabulation : 

■ Utiliser l'outil Tab Set ou la commande Set Tabs. 

■ Utiliser la boite de dialogue Style. 



Pour definir ou modifier des tabulations, vous pouvez utiliser l'outil Tab Set 
ou la commande Set Tabs : 

1. Cliquez sur l'outil Tab Set ou choisissez Options I Set Tabs. Le curseur 
devient l'icone Tab Set. Resource Workshop entoure tout controle 
actuellement defini comme taquet de tabulation par un cadre ombre. 

2. Pour definir un taquet de tabulation, cliquez sur tout controle non 
entoure par un cadre ombre. 

Pour annuler un taquet de tabulation, cliquez sur un controle entoure 
par un cadre ombre. 

3. Lorsque vous modifiez les taquets de tabulation, cliquez sur le Selecteur. 
Vous pourrez ainsi a nouveau editer votre boite de dialogue. 

Vous pouvez aussi utiliser une boite de dialogue Style pour modifier un 
taquet de tabulation : 

1. Ouvrez la boite de dialogue Style pour le controle (double-cliquez sur le 
controle, ou selectionnez-le et appuyez sur Entree). 

2. Activez Tab Stop (sous Attributes) pour definir un taquet de tabulation, 
ou desactivez Tab Stop pour annuler ce taquet. 

Vous pouvez tester votre boite de dialogue (voir la section "Comment tester 
une boite de dialogue" de ce chapitre) pour verifier si vos nouveaux taquets 
de tabulation sont corrects. 
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Regroupement de 
controles lies 



Vous pouvez definir des groupes de controles pour permettre a l'utilisateur 
de se deplacer parmi ces controles a l'aide des touches flechees. 

La definition des groupes est identique a celle des taquets de tabulation 
(decrite precedemment). Si vous utilisez l'outil Set Groups ou la commande 
Options I Set Groups, Resource Workshop specifie qu'un controle est 
repere comme appartenant a un groupe en l'entourant d'un cadre ombre. 
Vous pouvez aussi definir un groupe en activant l'attribut Group de la boite 
de dialogue Style du controle considere. 

Notez que vous marquez uniquement le premier controle de chaque groupe 
avec l'attribut Group. En respectant la sequence d'ajout des controles, 
Resource Workshop traite tous les controles suivants comme des elements 
du groupe, jusqu'a ce qu'il rencontre un autre controle dote de l'attribut 
Group. 

Souvenez-vous des points suivants a propos des groupes : 

■ L'ordre d'ajout des controles est important. 

■ Lorsque vous selectionnez un "groupe" de controles en faisant glisser un 
cadre de selection ou a l'aide d'un May-clic, il ne s'agit pas d'un groupe 
avec le sens utilise dans cette section. II s'agit simplement de plusieurs 
controles selectionnes. L'attribut Group peut seulement etre affecte par 
l'outil Set Group, la commande Options I Set Group, ou la case a cocher 
Group de la boite de dialogue Style. 



Comment 
reordonner les 
controles 
(sequence de 
tabulation) 



1.2 



Vous pouvez specifier l'ordre dans lequel les utilisateurs accederont aux 
controles dans une boite de dialogue. Comme specifie dans la section 
precedente, l'ordre est tres important lorsque vous definissez des groupes 
de controles lies. 

Pour specifier l'ordre de tabuation des controles dans une boite de dialogue : 

1. Selectionnez les controles que vous souhaitez deplacer dans la sequence. 

Pour specifier l'ordre de tous les controles dans la boite de dialogue, 
selectionnez aucun d'entre eux. 

2. Cliquez sur l'outil Set Order. Le curseur de la souris se transforme en 
icone Set Order. 

Chaque controle est numerate pour indiquer sa place dans la sequence. 
Si vous ne choisissez que certains controles dans l'etape 1, vous ne verrez 
que les numeros d'ordre de ces controles. 



Chapitre 15, Creation de boites de dialogue 



281 



Notez le message Next Item au bas de l'editeur Dialog. II vous indique 
le numero d'ordre que Resource Workshop affectera au prochain 
controle sur lequel vous cliquerez. 

3. Cliquez sur les elements auxquels vous souhaitez affecter de nouveaux 
numeros. L'editeur Dialog affiche un cadre autour des controles deja 
selectionnes. 

En affectant le nouveau numero, vous pouvez "revenir en arriere" en 
cliquant a nouveau le dernier controle que vous venez de cliquer : vous 
revenez ainsi au numero precedent. Vous pouvez continuer ainsi en 
cliquant sur les differents controles dans l'ordre inverse. 

4. Une fois les nouveaux numeros affectes, cliquez sur le Selecteur pour 
continuer l'edition. 

Vous pouvez aussi ordonner vos controles avec la commande menu 
Options I Set Order. Ensuite, choisissez Options I Modify Controls pour 
continuer a editer votre boite de dialogue. (Vous n'avez pas besoin de 
choisir cette commande si vous cliquez sur tous les controles selectionnes.) 



Agencement, 
alignement, et 
redimensionnement 
des controles 



Une fois les controles ajoutes a votre boite de dialogue, vous pouvez utiliser 
le menu editeur Dialog pour aligner et redimensionner les controles, et les 
disposer en rangees et colonnes. 



Comment aligner 
plusieurs controles 



Pour aligner des controles a l'aide de la commande Align : 

1. Selectionnez les controles a aligner. 

Notez que le cadre de selection entoure tous les controles selectionnes. 
Les controles individuels qui seront affectes par les options d'alignement 
sont reperes par un cadre ombre. 

2. Choisissez Align I Align. La boite de dialogue Align controls s'affiche 

3. Choisissez les options Vertical Alignment et Horizontal Alignment 
requises (voir ci-dessous) et cliquez sur OK pour executer le deplacement 
des controles selectionnes. 
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Tableau 15.3 
Options d'alignement 



Option 



Description 



Horizontal Alignment 
No Change 
Left Sides 

Centers 

Right Sides 

Space Equally 

Center in Dialog 

Vertical Alignment 
No Change 
Tops 

Centers 

Bottoms 

Space Equally 

Center in Dialog 



Aucun changement dans I'alignement horizontal. 

Aligne les controles afin que leurs cotes gauches coincident avec le 
cote gauche du cadre de selection. 

Aligne les controles afin que leurs centres horizontaux coincident 
avec le centre du cadre de selection. 

Aligne les controles afin que leurs cotes droits coincident avec le 
cote droit du cadre de selection. 

Deplace les controles horizontalement a I'interieur du cadre de 
selection afin qu'ils soient regulierement espaces. 

Deplace le cadre de selection horizontalement afin qu'il soit centre 
dans la boite de dialogue. La position relative des controles 
individuels a I'interieur du cadre de selection reste inchangee. 

Pas de changement dans I'alignement vertical. 

Aligne les controles afin que leurs cotes superieurs coincident avec 
le cote superieur du cadre de selection. 

Aligne les controles afin que leurs centres verticaux coincident avec 
le centre du cadre de selection. 

Aligne les controles afin que leurs cotes inferieurs coincident avec le 
cote inferieur du cadre de selection. 

Deplace les controles verticalement a I'interieur du cadre de 
selection afin qu'ils soient regulierement espaces. 

Deplace le cadre de selection verticalement afin qu'il soit centre 
dans la boite de dialogue. La position relative des controles 
individuels a I'interieur du cadre de selection reste inchangee. 



= | Alignment 


0= 


0=£> 


tt=a 


■=£■ 


A 


a 


s 


A 



Au lieu d'utiliser Align I Align Controls, vous pouvez utiliser la palette 
Alignment. Selectionnez les controles a aligner, puis choisissez un outil dans 
la palette Alignment. 

La seule option d'alignement qui n'apparait pas dans la palette Alignment 
est l'option Space Equally. Vous pouvez naturellement utiliser la boite de 
dialogue Align Controls, mais aussi espacer les controles regulierement en 
"allongeant" le cadre de selection : 

1. Selectionnez les controles a espacer regulierement. Un cadre de selection 
entoure les controles selectionnes. 
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2. Agrandissez le cadre de selection en maintenant la touche Ctrl enfoncee 
tout en faisant glisser le bord du cadre de selection dans le sens ou vous 
souhaitez espacer vos controles, soit : 

Pour espacer les controles de maniere reguliere dans la direction 
horizontale, allongez la bordure gauche ou droite du cadre de selection. 

Pour espacer les controles de maniere reguliere dans la direction verticale, 
allongez la bordure inferieure ou superieure du cadre de selection. 

Si vous allongez un coin du cadre de selection, une boite de dialogue 
s'affiche pour vous permettre de disposer les controles en rangees et en 
colonnes. 



Comment disposer 
les controles en 
colonnes et 
rangees 



□+□ 



La commande Align I Array dispose les controles en colonnes et rangees, en 
les alignant horizontalement ou verticalement avec un espacement regulier 
et en les renumerotant afin qu'ils soient tous ordonnes. 

Pour utiliser la commande Array : 

1. Selectionnez les controles que vous souhaitez disposer en colonnes et 
rangees. 

Notez que le cadre de selection entoure tous les controles selectionnes. 
Les controles individuels qui seront affectes par la commande Array sont 
reperes par un cadre ombre. 

2. Si necessaire, agrandissez ou reduisez la taille du cadre de selection pour 
en tourer la zone qui contiendra les colonnes et les rangees. Par exemple, 
si vous agrandissez le cadre de selection, la commande Array deplacera 
les controles vers les nouvelles limites definies par le cadre de selection. 

3. Choisissez Align I Array ou cliquez sur l'outil Duplicate. 

4. Sous Array Layout, specifiez le nombre de rangees et de colonnes 
souhaitees. 

5. Sous Order, specifiez l'ordre souhaite ( de gauche a droite ou de haut en 
bas). La figure suivante montre comment les deux options Order 
disposent differemment neuf controles en trois colonnes. 
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Figure 15.5 

Options d'ordre des 

controles 



1 




2 








4 




5 



De gauche a droite 



De haut en bas 



6. Une fois les options specifiers, cliquez sur OK. 

Pour plusieurs controles selectionnes, l'outil Duplicate a le meme effet que 
Align I Array. Lorsqu'un seul controle est selectionne, il a le meme effet que 
Edit I Duplicate (voir la section ' Ajout de plusieurs copies d'un controle" de 
ce chapitre). 



Comment 
redimensionner 
plusieurs controles 



Vous pouvez redimensionner plusieurs controles selectionnes avec les 
options de la boite de dialogue Size Controls : 

1. Selectionnez les controles a redimensionner. 

Notez que le cadre de selection entoure tous les controles selectionnes. 
Les controles individuels qui seront affectes par les options de 
modification de taille sont reperes par un cadre ombre. 

2. Choisissez Align I Size. La boite de dialogue ci-dessous s'affiche : 



Figure 15.6 

Boite de dialogue 

Size Controls 



Size controls 



Horizontal size 


+ No change 


Shrink to smallest 


Grow to largest 


Width of size box 


> Width of dialog 


)■ &?&m y&lmis. 



Vertical size 


+ No change 


Shrink to smallest 


Grow to largest 


Height of size box 


Height of dialog 


E?3m ¥$hm& 



* □ «□ Y □ "□ 



OK 



[Cancel 



"? Help 
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3. Pour redimensionner les controles selectionnes, choisissez les options 
Vertical Size et Horizontal Size requises (voir ci-dessous) et cliquez sur 
OK. 



Tableau 15.4 
Options Size 



Option 

Horizontal Size 
No Change 
Shrink to Smallest 

Grow to Largest 

Width of Size Box 

Width of Dialog 

Vertical Size 
No Change 
Shrink to Smallest 

Grow to Largest 

Height of Size Box 

Height of Dialog 



Description 

Aucun changement de taille horizontal. 

Reduit la largeur des controles pour s'adapter au controle 
selectionne le plus etroit. 

Augmente la largeur des controles pour s'adapter au controle 
selectionne le plus large. 

Redimensionne les controles pour qu'ils occupent toute la largeur du 
cadre de selection. 

Redimensionne les controles pour qu'ils occupent toute la largeur de 
la boite de dialogue. 

Aucun changement de taille vertical. 

Reduit la hauteur des controles pour s'adapter au controle 
selectionne le plus reduit en hauteur. 

Augmente la hauteur des controles pour s'adapter au controle 
selectionne le plus important en hauteur. 

Redimensionne les controles pour qu'ils occupent toute la hauteur 
du cadre de selection. 

Redimensionne les controles pour qu'ils occupent toute la hauteur 
de la boite de dialogue. 



Une fois que vous avez choisi les options de hauteur et de largeur voulues, 
selectionnez OK 

Pour annuler un redimensionnement, choisissez Edit I Undo, appuyez sur 
Alt+Retour arriere ou selectionnez l'outil Undo (Defaire). 



Options de 
dimensionnement 
pour un controle 
unique 



Si vous selectionnez un seul controle et que vous choisissez Align I Size, les 
options suivantes sont disponibles : 

■ No Change (horizontal et vertical) 

■ Width of Dialog (horizontal) 

■ Height of Dialog (vertical) 

■ Enter Values (horizontal et vertical) 
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Controles boutons 



Les options No Change, Width of Dialog et Height of Dialog fonctionnent 
comme indique au tableau 15.4. 

L'option Enter Values permet de specifier a la fois la taille et la position du 
controle selectionne. Les valeurs X et Y definissent la distance entre le coin 
superieur gauche du controle et le coin superieur gauche de la boite de 
dialogue (directement sous la barre de titre). Les valeurs CX et CY 
definissent la largeur et la hauteur du controle. (Toutes les valeurs sont 
mesurees en unites dialogue.) 

Vous pouvez "defaire" toute edition executee dans l'editeur Dialog 
(positionnement de controles, alignement, suppression, etc.), avec l'outil 
Undo ou la commande Edit I Undo. Undo s'applique aussi bien aux 
commandes qui portent sur des groupes de controles et aux commandes qui 
modifient des controles isolement. 

Les controles boutons incluent les boutons radio, les boutons-poussoirs, les 
cases a cocher et les boites de groupe. Pour ajouter des boutons a une boite 
de dialogue, utilisez la palette Tools (voir la section "Palette Tools" de ce 
chapitre) ; pour definir les attributs des nouveaux boutons ou pour modifier 
les controles boutons existants, utilisez la boite de dialogue Button Style 
(pour afficher cette boite de dialogue, double-cliquez sur le controle bouton 
a modifier). 

Pour modifier le type d'un bouton, choisissez une nouvelle option dans 
Button Type (voir tableau ci-dessous). 



Tableau 15.5 
Types de bouton 



Type de bouton Description 



Push Button Bouton portant un libelle. L'utilisateur clique sur le bouton qui envoie un 

message BN_CUCKED a la fenetre parent. 

Default Push Button Identique a un bouton-poussoir, mais comprend egalement une bordure en 
gras qui indique qu'il s'agit de la reponse par defaut si l'utilisateur appuie sur 
Entree. 

Bouton rectangulaire avec texte a sa gauche ou a sa droite. La case est 
marquee par un X lorsqu'elle est selectionnee. L'application doit elle-meme 
activer et desactiver la case. 

Identique a une case a cocher, mais Windows active et desactive la case a la 
place de l'application. 



Check Box 



Auto Check Box 
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Tableau 15.5 

Types de bouton 

(suite) 



Type de bouton Description 



3-State Identique a une case a cocher, mais avec un troisieme etat eventuel : le 

bouton apparait en grise pour indiquer que son etat est inconnu ou 
indetermine. C'est Implication qui doit activer, desactiver et estomper la case. 

Auto 3-State Identique a un bouton a 3 etats, mais Windows active et desactive la case a 

la place de I'application. 

Radio Button Bouton circulaire avec un texte identificateur a sa gauche ou a sa droite. Le 

cercle se remplit d'un point noir lorsqu'il est selectionne. C'est I'application qui 
doit remplir ou effacer le point. 

Les boutons radio doivent apparaitre en groupes. En general, un groupe de 
boutons radio offre a I'utilisateur un ensemble d'options mutuellement 
exclusives. 

Lorsque I'utilisateur clique sur un bouton radio, il envoie un message 
BN_CUCKED a la fenetre parent. 

Auto Radio Button Identique a un bouton radio mais Windows remplit ou efface le point a la 
place de I'application. 

Group Box Boite rectangulaire utilisee pour regrouper les boutons visuellement. Vous 

pouvez egalement inclure un libelle qui s'affichera dans Tangle superieur 
gauche de la boite. 

User Button Boutons personnalises pour compatibilite avec Windows 2.0. II est conseille 

de ne pas utiliser ces controles sous Windows 3.0 mais plutot les boutons 
Owner Draw (voir ci-dessous). 

Owner Draw Option qui permet a I'application de creer le bouton. Lorsqu'il doit apparaitre, 

le bouton envoie un message WM_DRAWITEM a son parent. 



Les options de justification (Alignment) determinent si le texte des boutons 
radio et des cases a cocher s'affiche a gauche ou a droite du bouton. 



Valeurs 

d'identificateur des 
controles 
bouton-poussoir 



Windows definit un ensemble de valeurs d'identificateur de controle pour 
les boutons-poussoirs standard utilises pour quitter les boites de dialogue. 
Vous pouvez entrer l'un des noms (en lettres majuscules) ou l'une des 
valeur d'identificateur du tableau 15.6. Cependant, a l'oppose des Controles 
Personnalises Windows de Borland (BWCC, decrits a l'annexe B), le 
changement d'identificateur de controle d'un bouton Windows standard ne 
modifie pas automatiquement le texte du bouton. Par exemple, pour creer 
un bouton OK, vous devez initialiser l'identificateur de controle a IDOK et la 
chaine Caption a OK. 
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Tableau 15.6 

Controles boutons 

Windows predefinis 



Norn 
Identificateur 

IDOK 

IDCANCEL 

IDABORT 

IDRETRY 

IDIGNORE 

IDYES 

IDNO 



Identificateur Valeur 
Type 



OK 

Cancel 

Abort 

Retry 

Ignore 

Yes 

No 



Controles barre de 
defilement 



Les fenetres, les boites de dialogue et les boites liste utilisent des barres de 
defilement pour preciser que des informations supplementaires sont 
affichables. Par exemple, si une boite liste de noms de fichiers permet 
d'afficher 10 noms et que le repertoire contient 20 fichiers, une barre de 
defilement indique a l'utilisateur l'existence de noms supplementaires. 

Une barre de defilement est un rectangle pourvu de fleches directionnelles a 
chaque extremite. Entre les fleches, une icone carree (appelee boite de 
defilement ou ascenseur) indique la position approximative de l'affichage par 
rapport a l'ensemble des informations. Par exemple, si l'ascenseur d'une 
boite liste contenant des noms de fichiers se trouve au milieu de la barre de 
defilement, cela signifie que l'utilisateur est en train de consulter les noms 
des fichiers situes au milieu de la liste. 

Dans une boite de dialogue, vous pouvez ajouter des barres de defilement 
vertical et horizontal a l'emplacement de votre choix. 

Pour placer des barres de defilement dans une boite de dialogue, utilisez la 
palette Tools ou les deux commandes de barre de defilement du menu 
Controls. Pour definir ou modifier les attributs d'une barre de defilement, 
double-cliquez sur celle-ci pour affichez la boite de dialogue Scroll Bar Style. 

La boite de dialogue Scroll Bar Style contient les options communes et les 
options d'attributs de controle presentees a partir des tableaux 15.1 et 15.2, 
ainsi que les options qui alignent la barre de defilement a l'interieur du 
cadre de selection (cf. tableau ci-dessous). 
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Tableau 15.7 

Options 

d'alignement pour 

barre de defilement 



Option 



Description 



None La barre de defilement remplit tout le cadre de selection (valeur par defaut). 

Si vous redimensionnez le cadre de selection, vous pouvez modifier les 
proportions de la barre de defilement, elargissant ainsi les boutons fleche et 
la boite de defilement. 

Top Left Une barre de defilement horizontal apparait en haut du cadre de selection et 

occupe toute la largeur de ce cadre. Une barre de defilement vertical apparait 
sur la gauche du cadre de selection et occupe toute la hauteur de ce cadre. 
La barre de defilement apparait toujours avec sa largeur standard. 

Bottom Right Une barre de defilement horizontal apparait en bas du cadre de selection et 

occupe toute la largeur de ce cadre. Une barre de defilement vertical apparait 
sur la droite du cadre de selection et occupe toute la hauteur de ce cadre. La 
barre de defilement apparait toujours avec sa largeur standard. 



Controles boite 
liste 



Une boite liste est un rectangle qui contient une liste de chaines texte. En 
general, l'utilisateur peut consulter puis selectionner un ou plusieurs 
elements dans une boite liste. La boite liste envoie alors a la fenetre parent 
un message relatif au(x) element(s) selectionne(s). 

Si la liste des elements est plus longue ou plus large que la boite liste, vous 
pouvez ajouter des barres de defilement a la boite. 

En dehors des options communes decrites dans le tableau 15.1, la boite de 
dialogue List Box Style comprend egalement les options Owner Drawing et 
List Box (cf. tableaux ci-dessous). 

Les options Owner Drawing permettent de determiner si la liste d'une boite 
liste doit etre creee par la boite liste ou par l'application. Selectionnez l'un 
des attributs suivants : 



Tableau 15.8 

Options Owner 

Drawing 



Option Description 

Not Owner Draw Le controle boite liste cree la liste (valeur par defaut). 

Fixed L'application cree la boite liste en reponse aux messages WM_DRAWITEM. 

L'application peut egalement repondre aux messages WM_COMPAREITEM, 
WM_DELETEITEM et WM_MEASUREITEM. 

Le controle boite liste transmet un message WM_MEASUREITEM a 
l'application uniquement au moment de la creation initiale de la boite liste, ce 
qui fixe la hauteur des elements de la boite liste. 
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Tableau 15.8 
Options Owner 
Drawing (suite) 



Option 



Description 



Variable L'application cree la boite liste en reponse aux messages WM_DRAWITEM. 

L'application peut egalement repondre aux messages WM_COMPAREITEM, 
WM_DELETEITEM et WM_MEASUREITEM. 

Le controle boite liste envoie un message WM_MEASUREITEM a 
l'application pour chaque element de la boite liste. La hauteur de chaque 
element peut varier. 

Les options List Box permettent de mieux definir une boite liste. Choisissez 
une ou plusieurs options du tableau ci-dessous : 



Tableau 15.9 
Options List Box 



Option 



Description 



Notify 

Sort 
Multiple Select 

Don't Redraw 
Tab Stops 



Integral Height 



Multi Column 



Pass Keyboard 
Input 



Envoie un message de saisie a la fenetre parent lorsque I'utilisateur clique 
sur un element de la liste (defaut). 

Trie la liste dans I'ordre alphabetique. 

Permet a I'utilisateur de selectionner plusieurs elements. L'utilisateur peut 

egalement activer et desactiver certains elements. 

Evite de recreer une boite liste modifiee. 

Organise les informations de la boite liste en colonnes. La largeur de colonne 
par defaut est de 32 unites dialogue ou 8 caracteres. Utilisez les caracteres 
Tab (\x09) pour formater le texte. 

Si vous souhaitez modifier la largeur de colonne, l'application doit definir ses 
propres taquets de tabulation avec le message LB_SETTABSTOPS. 

Reduit la hauteur de la boite liste, si necessaire, jusqu'au multiple entier le 
plus proche de la hauteur de police en cours (valeur par defaut). 

Par exemple, une boite liste peut contenir trois elements affiches en totalite, 
et un quatrieme element dont I'affichage est tronque. Si Integral Height est 
active, la taille de la boite liste va diminuer au moment de I'execution a 
I'espace requis pour trois elements (trois fois la hauteur de police). 

Cree une boite liste dans laquelle le texte passe du bas d'une colonne au 

haut de la colonne.suivante. Pour afficherdu texte supplemental, 

I'utilisateur fait defiler la boite liste horizontalement. 

Si vous activez cette option, l'application doit envoyer le message 

LB_SETCOLUMNWIDTH pour definir la largeur de toutes les colonnes (en 

pixels). 

Transmet a l'application les donnees saisies par I'utilisateur. 
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Tableau 15.9 

Options List Box 

(suite) 



Option 



Description 



Extend Select Avec les boites liste a selection multiple, cet attribut modifie la maniere dont 

la selection multiple s'effectue. L'utilisateur peut ainsi selectionner plusieurs 
elements dans la liste. 

Has Strings Si vous avez choisi I'option Owner Drawing Fixed ou Variable, la boite liste 

enregistre le texte de chaque element de la liste a I'aide d'un message 
LBJNSERTSTRING ou LB_ADDSTRING. La boite liste peut egalement 
restituer les elements de liste a I'aide du message LBGETTEXT. 

Scroll Bar Always (Windows 3.1 uniquement) La boite liste affiche toujours une barre de 
defilement vertical, quel que soit le nombre d'elements de cette liste. La 
constante WINDOWS.H pour ce style est LBS_DISABLENOSCROLL. 



Controles boite de 
saisie 



Le controle boite de saisie permet a l'utilisateur d'entrer du texte a partir du 
clavier. Ce controle est utilise par exemple dans la boite de dialogue File 
Open. 



Figure 15.7 

Controle boite de 

saisie dans la boite 

de dialogue File 

Open 



Filename |BH I 





Pour definir les attributs d'un controle boite de saisie, double-cliquez sur ce 
controle dans la boite de dialogue. La boite de dialogue Edit Text Style 
s'affiche. 

Cette boite de dialogue contient les options communes et les options 
d'attributs de controles presentees a partir du tableau 15.1, ainsi que les 
options ci-apres : 

■ Alignement 

■ Barres de defilement 

■ Defilement automatique 

■ Options ligne simple ou lignes multiples 

■ Options minuscule/majuscule 

■ Autres options, y compris les options specif iques a Windows 3.1 

Le tableau suivant decrit les options de la boite de dialogue Edit Text Style. 
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Tableau 15.10 

Options de la boite 

de dialogue Edit 

Text Style 



Option 



Description 



Alignement 

Left 

Right 

Center 
Banes de defilement 

Horizontal 

Vertical 

Defilement automatique 
Horizontal 



Vertical 



Majuscule/minuscule 
Case Insensitive 
Upper Case 

Lower Case 
Ligne(s) Line 
Single Line 
Multiple Line 



Aligne a gauche un texte de plusieurs lignes (valeur par defaut). 
Aligne a droite un texte de plusieurs lignes. 
Centre un texte de plusieurs lignes. 



Lorsque cette option est activee, le controle boite de saisie dispose 
d'une barre de defilement horizontal en bas de sa fenetre. 

Lorsque cette option est activee, le controle boite de saisie dispose 
d'une barre de defilement vertical sur le bord droit de sa fenetre. 



Si I'utilisateur tape un caractere au niveau du bord droit de la limite 
de la boite de saisie, le texte defile automatiquement de 
1 caracteres vers la droite. Si I'utilisateur appuie sur Entree, le texte 
defile a nouveau jusqu'a la position zero. 

Si I'utilisateur appuie sur Entree a la derniere ligne du controle boite 
de saisie, le texte redefile sur une pleine page. Par exemple, si la 
longueur du controle est de 5 lignes et que vous appuyez sur Entree 
a la derniere ligne, le texte remonte de 5 lignes. Le curseur revient 
sur la ligne du haut. 

Pour que cette option puisse s'appliquer, n'oubliez pas de definir le 
controle boite de saisie autorisant plusieurs lignes. 

Remarque : L'appui sur Entree est sans effet lorsque Resource 
Workshop est en mode Test, mais vous constaterez cet effet dans 
votre application. 

Affiche le texte exactement comme il est saisi (valeur par defaut). 

Affiche tout le texte en lettres majuscules, quel que soit le mode de 
saisie. 

Affiche tout le texte en minuscules, quel que soit le mode de saisie. 

Limite la boite de saisie a une seule ligne (valeur par defaut). 

Permet a I'utilisateur de taper le texte sur plusieurs lignes. Pour 
autoriser le defilement d'un texte de plusieurs lignes, activez I'option 
Vertical Automatic Scroll. 
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Tableau 15.10 

Options de la boite 

de dialogue Edit 

Text Style (suite) 



Option 



Autres options 
Password 



Convert OEM 



Keep Selection 



Description 



Si vous selectionnez Password, les lettres tapees ne sont pas 
affichees (dies sont remplacees par des asterisques). Cette option 
est utile pour les mots de passe et les donnees confidentielles. 

Convertit le texte saisi dans le controle selon le jeu de caracteres 
courant OEM puis reconvertit le texte en ANSI. Cette option est utile 
dans les boites de saisie de fichiers car elle permet a tout nom de 
fichier entre d'etre traduit dans le jeu de caracteres OEM, qui est 
utilise par le systeme de fichiers DOS. 

Conserve le texte sdectionne en surbrillance, meme si ce controle 
n'est pas commande par le clavier. Par exemple, si un utilisateur met 
en surbrillance du texte dans un controle boite de saisie, puis passe 
a un autre controle, le texte perd sa surbrillance, sauf si vous avez 
affecte le controle boite de saisie de I'attribut Keep Selection. 



Tableau 15.11 
Styles Windows 3.1 



Les options suivantes sont uniquement disponibles sous Windows 3.1. 



Type 



Description 



Read Only Le texte est accessible en lecture seulement. La constante WINDOWS.H 

pour ce style est ES_READONLY. 

Want Return Pour un controle boite de saisie a plusieurs lignes qui est commande par le 

clavier, la touche Entree impose un saut de ligne dans ce controle. Si le 
controle n'est pas commande par le clavier, le retour chariot s'applique au 
bouton-poussoir par defaut. Si le controle ne dispose pas de cet indicateur, 
I'utilisateur doit appuyer sur Ctrl+Entree pour creer un saut de ligne. La 
constante WINDOWS.H pour ce style est ES_WANTRETURN. 



Controles statiques 



Les outils de ces 

controles sont illustres 

par la figure 15.3. 



Un controle statique affiche un texte ou un graphique non modifiable par 
I'utilisateur. Vous pouvez utiliser les controles statiques pour libeller 
certaines parties de votre boite de dialogue ou pour presenter les 
informations sous forme graphique. 

Les controles statiques de la palette Tools sont les suivants : 

■ Texte statique 

■ Icone 

■ Cadre 

■ Rectangle 
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Vous pouvez definir les attributs des controles statiques a l'aide de la boite 
de dialogue Static Style, qui s'affiche par un double-clic sur le controle 
statique requis dans sa boite de dialogue. 

La boite de dialogue Static Style comprend les options communes et les 
options d'attributs de controles presentees a partir de la section "edition des 
controles" plus haut dans ce chapitre (excepte les options de barre de 
defilement), ainsi que plusieurs options specifiques aux controles statiques. 

La case a cocher No Character Underline permet de desactiver le 
soulignement de caracteres. Vous pouvez souligner un caractere texte dans 
votre controle statique en le precedant du symbole &. Si vous activez No 
Character Underline, le soulignement est desactive et les symboles & sont 
affiches en tant que caracteres litteraux. 

Les options Control Type vous permettent de definir plus en detail le type 
de controle statique. Choisissez une des options ci-apres : 



Tableau 15.12 
Options Control Type 



Option Description 

Left Text Affiche le texte tout a fait a gauche dans la bordure du controle 

(defaut). Si le texte s'etend au-dela de la bordure du cadre, il passe 
automatiquement a une nouvelle ligne. 

Le texte, dans tous ces styles, utilise la couleur Window Text en 
cours du panneau de configuration. 

Left Text -No Wrap Affiche le texte tout a fait a gauche dans la bordure du controle. 

Toute ligne de texte qui s'etend au-dela de la bordure du cadre est 
coupe. 

Centered Text Affiche le texte centre a I'interieur de la bordure du controle. Si le 

texte s'etend au-dela de la bordure du cadre, il passe 
automatiquement a une nouvelle ligne. 

Right Text Affiche le texte tout a fait a droite dans la bordure du controle. Si le 

texte s'etend au-dela de la bordure du cadre, il passe 
automatiquement a une nouvelle ligne. 

Dans tout le texte statique excepte Simple Text, vous pouvez 
realiser des tabulations de texte en tapant \t, et forcer le passage a 
une nouvelle ligne avec \r. 
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Tableau 15.12 
Options Control Type 



Option 



Description 



Simple Text Affiche une seule ligne de texte tout a fait a gauche. N'utilisez pas 

des caracteres de tabulation, et ne forcez pas le passage a une 
nouvelle ligne. 

Simple Text ne gere pas le message WM_CTLCOLOR. En plus de 
recevoir sa couleur texte a partir du panneau de configuration, son 
fond utilise la couleur du fond de fenetre en cours. 

White Rectangle Affiche un rectangle plein qui utilise le jeu de couleurs du fond de 

fenetre en cours dans le panneau de configuration. La couleur 
Windows par defaut du fond de fenetre est le blanc. 

Gray Rectangle Affiche un rectangle rempli qui utilise le jeu de couleurs du fond 

d'ecran (le bureau) en cours dans le panneau de configuration. La 
couleur Windows par defaut du bureau est le gris. 

Black Rectangle Affiche un rectangle rempli qui utilise le jeu de couleurs du cadre de 

fenetre en cours dans le panneau de configuration. La couleur 
Windows par defaut des cadres de fenetre est le noir. 

White Frame Affiche un cadre vide avec un contour plein qui utilise le jeu de 

couleurs du fond de fenetre en cours dans le panneau de 
configuration. La couleur Windows par defaut du fond de fenetre est 
le blanc. 

Gray Frame Affiche un cadre vide avec un contour plein qui utilise le jeu de 

couleurs du fond d'ecran (le bureau) en cours dans le panneau de 
configuration. La couleur Windows par defaut du bureau est le gris. 

Black Frame Affiche un cadre vide avec un contour plein qui utilise le jeu de 

couleurs du cadre de fenetre en cours dans le panneau de 
configuration. La couleur Windows par defaut des cadres de fenetre 
est le noir. 

Remarque : Lorsque vous ajoutez un cadre a votre boite de 
dialogue, il vous semble rempli avec la couleur du fond de fenetre en 
cours. Si vous activez le mode Test, vous verrez le cadre tel qu'il 
apparaitra lors de I'execution. 

Icon Affiche une icone. Utilisez le bouton Edit Icon pour lancer I'editeur 

Bitmap de maniere a pouvoir editer I'icone. 
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Controles 
statiques icone 



□ 



Si la boite de saisie 

Caption ne contient pas 

I'identificateur ou le 

nom de la ressource 

icone, l'icone ne 

s'affichera pas. 



Resource Workshop vous permet d'afficher des icones dans une boite de 
dialogue. L'icone doit faire partie du projet courant en tant que ressource 
integree ou liee. 

Pour placer un controle statique icone dans votre boite de dialogue : 

1. Cliquez sur le controle statique icone dans la palette Tools et faites-le 
glisser dans votre boite de dialogue. Placez le cadre a l'endroit ou doit 
apparaitre l'icone. 

2. Double-cliquez a l'interieur du cadre de selection du controle pour 
afficher la boite de dialogue Static Style. 

3. Dans la boite de dialogue Static Style, entrez le nom ou I'identificateur de 
la ressource icone dans la boite de saisie Caption, et cliquez sur le bouton 
radio approprie : Text pour un nom, Number pour un identificateur. 

Si vous utilisez un identificateur (son nom ou sa valeur numerique) dans 
la boite de saisie Caption, vous devez selectionner l'option Number. Par 
exemple, si vous avez cree I'identificateur GLOBE avec une valeur de 
1300, vous pouvez entrer GLOBE ou 1300 dans la boite de saisie Caption, 
mais dans les deux cas vous devez selectionner Number. 

Si l'icone se nomme GLOBE et que vous n'avez pas cree d'identificateur, 
tapez GLOBE dans la boite de saisie Caption et selectionnez le bouton 
radio Text. 

4. Choisissez OK. L'icone apparait dans votre boite de dialogue. 

5. Si vous souhaitez editer l'icone, double-cliquez-la pour afficher a 
nouveau la boite de dialogue Static Style. Le bouton Edit Icon est 
maintenant active. Cliquez-le pour lancer l'editeur Bitmap de maniere a 
pouvoir editer l'icone. 



Controles boites a 
options combinees 



Une boite a options combinees associe une boite liste (controle qui permet a 
l'utilisateur de consulter et de selectionner des chaines) avec un controle 
statique (texte non modifiable par l'utilisateur) ou avec un controle boite de 
saisie (zone ou un utilisateur peut entrer son texte). 



Figure 15.8 

Boite a options 

combinees dans la 

boite de dialogue 

Open File 



File type 



IRC resource script 



Vous pouvez definir les attributs d'une boite a options combinees en 
utilisant la boite de dialogue Combo Box Style. Pour afficher la boite de 
dialogue Combo Box Style, double-cliquez sur la boite a options combinees 
de votre boite de dialogue. 
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Les trois options Type vous permettent de definir la boite a options 
combinees. 



Tableau 15.13 
Types de boites a 
options combinees 



Option 



Description 



Simple La liste deroulante s'agrandit toujours pour afficher les elements de la liste. 

En outre, I'utilisateur peut editer les elements de la liste (defaut). 

Drop Down Lorsque la boite de dialogue s'affiche, la boite a options combinees 

comprend une seule ligne de texte editable. L'utilisateur peut cliquer sur la 
fleche vers le bas pour agrandir la liste, et editer tous les elements de la liste. 

Drop Down List Fonctionne comme une liste deroulante mais elle est statique. L'utilisateur 
peut selectionner des elements mais ne peut apporter aucune modification. 



Les options Owner Drawing vous permettent de determiner si la liste 
contenue dans la boite liste doit etre dessinee par la boite liste elle-meme ou 
par l'application. 



Tableau 15.14 

Options Owner 

Drawing 



Option 



No 
Fixed 



Variable 



Has Strings 



Description 



Le controle boite liste dessine la liste (defaut). 

L'application dessine la boite liste en reponse aux messages 
WM_DRAWITEM. L'application peut aussi repondre aux messages 
WM_COMPAREITEM, WM_DELETEITEM, et WM_MEASUREITEM. 

Le controle boite liste envoie le message WM_MEASUREITEM a l'application 
uniquement au moment ou la boite liste est dessinee. La taille de la boite liste 
est done fixe. 

L'application dessine la boite liste en reponse aux messages 
WMJDRAWITEM. L'application peut aussi repondre aux messages 
WM_COMPAREITEM, WM_DELETEITEM, et WM_MEASUREITEM. 

Le controle boite liste envoie le message WM_MEASUREITEM a l'application 
pour chaque element de la boite liste. La taille de la boite liste peut done 
varier. 

Si vous avez choisi Fixed ou Variable, la boite liste memorise le texte de 
chaque element avec le message LB_SETTEXT. La boite liste peut aussi 
restituer les elements de liste a partir de LB_GETTEXT. 



La boite de dialogue Combo Box Style comprend les options communes et 
les options d'attributs de controles repertories a partir du tableau 15.1 ainsi 
que les options specif iques aux controles de la boite a options combinees. 
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Tableau 15.15 

Attributs de la boite 

a options combinees 



Option 



Description 



Vertical Scroll Place une barre de defilement vertical dans la boite liste. 

Sorted Trie automatiquement les elements d'une boite liste par ordre alphabetique. 

Integral Height Redimensionne la boite liste pendant I'execution pour que tous les elements 

de la liste s'affichent completement (defaut). Si vous voulez controler 
precisement la hauteur de la boite liste, desactivez cette option. 

OEM Conversion Convertit le texte que I'utilisateur tape dans le jeu de caracteres OEM 

courant, et reconvertit le texte en ANSI. Cette option est utile dans les boites 
de saisie des noms de fichiers, car tout nom de fichier entre pourra etre 
traduit dans le jeu de caracteres OEM, utilise par le systeme de fichiers DOS. 

AutoHorizontal Defilement automatique du texte vers la gauche s'il depasse la largeur du 

controle. 

Vertical Scroll (Windows 3.1 uniquement). La boite a options combinees affiche toujours 

Always une barre de defilement vertical, quel que soit le nombre d'elements qu'elle 

contient. La constante WINDOWS.H pour ce style est 

CBS DISABLENOSCROLL. 



Controles 
personnalises 



Si vous souhaitez utiliser un controle qui ne correspond pas a un des types 
predefinis de Windows, vous pouvez utiliser un controle personnalise. Les 
controles predefinis dont nous avons deja parle dans ce chapitre (boites liste, 
barres de defilement, boutons, etc.) sont des controles standard. lis ont ete 
developpes par Microsoft et font partie de Windows. Le controle 
personnalise est une autre classe de fenetres a inclure dans vos boites de 
dialogue. 

II existe deux types de controles personnalises : les controles a installer et 
ceux specifiques a l'application. Vous devez implementer les controles 
personnalises installables en utilisant un fichier bibliotheque liee 
dynamiquement. Les controles personnalises specifiques a une application 
sont implemented dans l'application elle-meme. Resource Workshop les 
dessine sous forme de boites grises ou de cadres vides. 



Creation de 

controles 

personnalises 



Si vous souhaitez creer vos propres controles personnalises, vous devez les 
concevoir et les memoriser dans les fichiers DLL. La creation de classes de 
controles personnalises est decrite dans le fichier CUSTCNTL.RW, qui a ete 
copie sur votre disque dur par le programme d'installation de Resource 
Workshop. 
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Installation d'une 
bibliotheque de 
controles (.DLL ou 
.VBX) 



Les controles personnalises sont memorises dans des DLL. Pour ajouter des 
controles personnalises a votre boite de dialogue, installez les fichiers DLL 
ou VBX appropries. Ensuite, les controles personnalises de cette DLL seront 
disponibles comme tout autre controle Windows standard. 

Pour installer un fichier DLL contenant une bibliotheque de controles 
personnalises, procedez comme suit : 

1. Dans l'editeur Dialog, choisissez Options I Install Control Library. Vous 
verrez la boite de dialogue Install a New Control Library. 

2. Specifiez le fichier .DLL ou .VBX du controle personnalise. 

3. Choisissez OK. 

Vous pouvez maintenant ajouter les controles du fichier DLL dans votre 
boite de dialogue. 



Affichage des 

controles 

personnalises 



Avant d'ajouter des controles personnalises a votre boite de dialogue, 
choisissez Options I Preferences pour voir comment vos boites de dialogue 
vont s'afficher. Si Drawing Type est positionne a Normal, et si l'option Draw 
Custom Controls as Frames est activee, vos controles personnalises 
s'afficheront comme des contours rectangulaires. Dans ce cas, vous voudrez 
sans doute changer un de ces parametres, ou bien les deux. Reportez-vous 
au tableau 15.18 pour de plus amples informations sur les options Drawing 
Type, et a la section "Personnalisation de l'editeur Dialog" pour de plus 
amples informations sur l'option Draw Custom Controls as Frames. 



Ajout d'un controle 
personnalise 



Une fois le fichier DLL contenant les controles personnalises installe, vous 
pouvez ajouter le controle voulu a vos boites de dialogue. 

Si le type de vos controles personnalises est reconnu par Resource 
Workshop (voir la section "Comment travailler avec les controles" de ce 
chapitre), leurs icones apparaissent dans la colonne (ou les colonnes) de 
droite de la palette Tools. Vous pouvez les selectionner directement a partir 
de la palette. 

Si le type de vos controles personnalises n'est pas reconnu par Resource 
Workshop, vous devez suivre les etapes ci-dessous : 

1. Cliquez sur l'outil de controle personnalise ou choisissez Control I 
Custom pour afficher la boite de dialogue New Custom Control. 
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3. 



4. 



Dans la liste deroulante a cote de Class, choisissez le controle 
personnalise souhaite. Resource Workshop affiche un exemple du 
controle personnalise selectionne au centre de la boite de dialogue. 

Lorsque vous avez selectionne le controle personnalise de votre choix, 
choisissez OK. Le curseur de la souris se transforme en croix, indiquant 
ainsi qu'il est pret a positionner le controle personnalise. 

Cliquez dans la fenetre de la boite de dialogue a l'endroit ou vous 
souhaitez placer le controle personnalise. 



Comment tester une boite de dialogue 



Pour tester votre boite de dialogue afin que vous puissiez voir les effets des 
modifications apportees, selectionnez l'outil Test ou choisissez Options I 
Test Dialog. 



Test 



Appuyez sur Tab et sur les touches flechees pour voir comment vous 
deplacer dans votre boite de dialogue. Vous pouvez aussi taper du texte 
pour voir comment le texte defile dans un controle boite de saisie. Verifiez si 
vos controles sont ordonnes dans l'ordre souhaite. 

Lorsque vous testez une boite de dialogue, la ligne d'etat au bas de l'editeur 
Dialog indique Test. 

Pour quitter le mode test et retourner au mode d'edition, executez une des 
etapes suivantes : 

■ Cliquez sur le bouton OK ou Cancel de la boite de dialogue. 

■ Choisissez a nouveau Options I Test Dialog. 

■ Appuyez sur Entree. 

■ Cliquez deux fois sur le Selecteur (le premier clic vous bascule de la boite 
de dialogue a l'editeur Dialog). 
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Enregistrement d'une boite de dialogue 



Prenez l'habitude d'enregistrer vos changements au fur et a mesure, au lieu 
d'attendre un message de Resource Workshop vous invitant a le faire lors 
de la fermeture du projet. Executez une des etapes ci-dessous pour 
enregistrer les changements effectues a une boite de dialogue. 

■ Enregistrer le projet entier 

■ Enregistrer la boite de dialogue dans un fichier script de ressources de 
dialogue (.DLG). 



Enregistrement du 
projet 



Pour enregistrer le projet, choisissez File I Save Project. Resource Workshop 
compile les ressources modifiees depuis la derniere compilation et les 
memorise dans le fichier projet. 



Enregistrement 
d'une boite de 
dialogue dans un 
fichier 



Le chapitre 3 decrit la 

procedure d'ouverture 

d'un projet. 



Vous pouvez aussi stocker vos ressources de boites de dialogue dans un 
fichier script de ressources de dialogue .DLG. Un fichier dialogue contient 
normalement le script ressource pour une ou plusieurs boites de dialogue, 
mais il peut contenir toute information contenue dans un fichier .RC, y 
compris d'autres ressources (a la fois integrees et liees) et projets. Si vous 
ajoutez un fichier dialogue a un projet, Resource Workshop ajoute 
automatiquement une reference rcinclude dans la fenetre projet pour 
referencer un fichier dialogue. 

Pour memoriser des boites de dialogue dans un fichier .DLG, ajoutez un 
fichier dialogue au projet. Vous pourrez ensuite decider de memoriser les 
boites de dialogue dans ce fichier dialogue a mesure que vous les creez. 
Pour ajouter un fichier dialogue a un projet et y memoriser une nouvelle 
ressource : 

1. Choisissez File I Add to Project. La boite de dialogue Add File to Project 
s'affiche. 

2. Dans la boite liste deroulante File Type, selectionnez DLG Resource 
Script. 

3. Tapez un nouveau nom de fichier dans la boite de saisie File Name. 

4. Choisissez OK. Une boite de dialogue s'affiche avec le message : 
" <filename> does not exist. Create?". 

5. Choisissez Yes. 

Une instruction rcinclude s'ajoute a votre fenetre projet. Si vous ne la 
voyez pas, selectionnez la fenetre projet, puis choisissez View I By File. 
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Vous avez cree un fichier .DLG vide. Maintenant, vous allez creer une 
nouvelle boite de dialogue et l'ajouter au fichier. 

1. Choisissez Resource I New. La boite de dialogue New Resource s'affiche. 

2. Selectionnez le fichier script de dialogue cree dans la boite a options 
combinees "Place resource in". 

3. Dans la boite liste Resource Type, double-cliquez DIALOG, ou 
selectionnez DIALOG et choisissez OK. 

Lorsque vous editez votre boite de dialogue et quittez l'editeur Dialog, vous 
verrez une entree DIALOG au-dessous de l'instruction rcinclude du fichier 
.DLG de la fenetre projet. 



Visualisation de deux boites de dialogue 



Pour visualiser ou comparer deux boites de dialogue en meme temps, 
suivez les etapes ci-apres : 

1. Dans la fenetre projet, double-cliquez sur le nom de la premiere boite de 
dialogue a visualiser. L'editeur Dialog s'active et affiche cette boite de 
dialogue. 

2. Cliquez sur l'outil Test ou choisissez Options I Test Dialog. 

3. Cliquez deux fois sur le bouton Reduction de l'editeur Dialog (le premier 
clic vous bascule de la boite de dialogue a la fenetre de l'editeur Dialog). 
Votre boite de dialogue est maintenant une boite non modale que vous 
pouvez deplacer. 

4. Revenez a la fenetre projet et double-cliquez sur le nom de la seconde 
boite de dialogue a visualiser. Un second editeur Dialog s'active. 

5. Cliquez a nouveau sur l'outil Test ou choisissez Options I Test Dialog 
dans le second editeur Dialog. 

6. Cliquez deux fois sur le bouton Reduction du second editeur Dialog. 

Vous disposez maintenant de deux boites de dialogue non modales que 
vous pouvez placer cote a cote. 

Pour quitter le mode Test, cliquez sur le bouton OK ou Cancel de votre boite 
de dialogue, ou double-cliquez sur son icone menu Control. 
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Personnalisation de I'editeur Dialog 



Resource Workshop permet de modifier certaines parties de I'editeur 
Dialog. Choisissez Options I Preferences pour afficher la boite de dialogue 
Preferences. 

Les unites de la ligne d'etat determinent l'unite de mesure que la ligne d'etat 
utilise pour afficher les informations. 



Tableau 15.16 
Unites ligne d'etat 



Unite 

Dialog 

Screen 



Description 

Utilise l'unite dialogue comme unite de mesure sur la ligne d'etat. Dans une 
unite dialogue, y est egal a 1/8 de la hauteur de police et x a 1/4 de la largeur 
de police. 

Utilise le pixel comme unite de mesure sur la ligne d'etat. 



Les options Selection Border vous permettent de modifier l'aspect du cadre 
qui entoure les controles selectionnes. 



Tableau 15.17 

Options Selection 

Border 



Option 



Description 



Thick frame Le cadre de selection est epais, comme le cadre standard autour d'une 

application Windows ou d'une fenetre de boite de dialogue (defaut). 

Handles Le cadre de selection est un contour rectangulaire avec des poignees (petits 

carres) a chaque angle et au milieu de chaque cote. 



Les options Drawing Type determinent le type d'affichage des elements de 
votre boite de dialogue dans I'editeur Dialog. 



Tableau 15.18 

Options Drawing 

Type 



Type de dessin Description 



Draft 



Normal 



Dessine chaque controle sous forme d'un rectangle avec son 
identificateur de controle centre a l'interieur. Cette option vous permet 
aussi de voir Fespace occupe par le cadre de selection du controle. 

Dessine les controles Windows standard comme ils apparaitront au moment 
de I'execution. Le dessin de controles personnalises est determine par la 
case a cocher Draw Custom Controls as Frames, decrite brievement. 
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Tableau 15.18 

Options Drawing 

Type (suite) 



Type de dessin Description 



WYSIWYG Lorsque cette option est selectionnee, Resource Workshop cree les fenetres 

dialogue et les controles fenetre enfant, et les controles dessinent 
eux-memes. Cette option est plus lente, mais plus precise. Les controles 
personnalises installables se dessinent eux-memes. C'est I'option par defaut. 



Tableau 15.19 
Options Selection 



Les options Selection "definissent les regies" sur la facon de selectionner les 
controles. Si vous travaillez avec des controles peu espaces, vous activerez 
ces options pour obtenir une meilleure precision et pour eviter de 
selectionner des controles par inadvertance. 



Option 



Description 



Select Near Border, Cette option s'applique a Taction de cliquer pour 
selectionner des controles. Si elle est activee, vous devez cliquer sur la 
bordure du controle. Si elle est desactivee, vous devez cliquer n'importe oil a 
Tinterieur de la bordure du controle. 

Selection Rectangle Cette option s'applique a Taction de faire glisser le cadre de selection pour 
Surrounds selectionner des controles. Si elle est activee, vous devez entourer 

entitlement le controle (ou les controles) a I'aide du rectangle de selection. Si 
elle est desactivee, le rectangle de selection a seulement besoin de toucher 
le controle (ou les controles). 



Pour plus 

d'informations sur le 

langage script 

ressource, utilisez le 

systeme d'aide. 



Dans le langage script ressource, chaque type de controle dialogue a une 
syntaxe unique. Par exemple, le texte statique centre utilise l'instruction 
CTEXT. Neanmoins, l'instruction CONTROL peut specifier tout type de 
controle de dialogue. Si vous souhaitez que Resource Workshop genere 
uniquement des instructions CONTROL dans votre script ressource, plutot 
que des instructions de controle dialogue specifiques, selectionnez I'option 
Generate CONTROL Statements Only. 

La case a cocher Draw Custom Controls as Frames est uniquement 
disponible lorsque Drawing Type est initialise a Normal (voir le tableau 
15.18). Lorsque I'option est activee, les controles personnalises sont dessines 
comme des contours rectangulaires vides. Lorsque I'option est desactivee, 
les controles personnalises sont dessines comme des rectangles gris avec 
leur texte (s'il existe) dans un rectangle blanc au centre. Dessiner des 
controles personnalises comme des cadres peut accelerer le dessin de vos 
boites de dialogue a l'ecran. 
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Si vous cochez la case Ctl3d.dll, l'editeur Dialog applique aux controles 
(boutons radio, cases a cocher) l'aspect en relief utilise sous Windows. 
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Creation de menus 



L'utilisateur choisit une commande a partir d'une liste de commandes, 
appelee menu. Grace aux applications gerees par menus, l'utilisateur n'a pas 
besoin de connaitre la syntaxe d'une ligne de commande complexe. Par 
consequent, les menus facilitent l'utilisation d'une application. 

La plupart des applications Windows ont une barre menu, en haut de 
l'ecran, qui contient les noms des menus de l'application. Chaque menu 
contient un ensemble de commandes. Par exemple, la plupart des 
programmes Windows comprennent un menu Fichier, avec des commandes 
de creation, d'ouverture, d'enregistrement et d'impression de fichiers. 

L'editeur Menu de Resource Workshop vous permet de creer et d'editer 
facilement des menus pour votre application. Travailler avec des menus 
implique quatre etapes fondamentales : 

1. Lancer l'editeur Menu. 

Si vous creez une nouvelle ressource menu, l'editeur Menu vous 
presente un "modele" de menu. Si vous modifiez une ressource menu 
existante, celle-ci apparait dans l'editeur Menu. 

2. Creer et editer le menu. 

3. Tester le menu. 

4. Enregistrer le menu. 



Terminologie Ce chapitre utilise plusieurs termes pour decrire les elements d'une 

ressource menu : 

■ Une commande surgissante provoque l'affichage d'un menu. Elle peut 
apparaitre dans la barre menu, comme les noms de menus Windows 
standard Fichier et Aide. Elle peut aussi apparaitre a l'interieur de menus 
surgissants, ou elle provoque l'affichage d'un autre menu, appele "menu 
en cascade". 
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Voir la documentation 

de votre compilateur 

pour obtenir des 

informations sur la 

fonction 

TrackPopupMenu. 



Un menu surgissant est une boite rectangulaire qui contient une liste de 
commandes d'application, a partir de laquelle un utilisateur choisit une 
commande. II existe deux formes de menus surgissants : 

• Les menus deroulants sont affiches a partir d'une barre menu ou depuis 
un menu. lis sont lies a une commande surgissante et sont toujours 
affiches a partir de ce nom de commande. Par exemple, le menu 
deroulant File apparait toujours directement sous la commande 
surgissante File de la barre menu. 

• Les menus flottants peuvent apparaitre n'importe ou dans la fenetre 
application. Leur position est controlee par la fonction TrackPopupMenu. 

Un element de menu est une commande qui apparait dans un menu (par 
exemple, Open, Save ou Print). 

Un separateur de menu est une ligne qui divise les elements de menu en 
groupes logiques. Leur seule fonction est de faciliter la lecture et l'emploi 
d'un menu. Vous ne pouvez pas editer des separateurs de menu. 



Lancement de I'editeur Menu 



Les deux sections suivantes decrivent la procedure de lancement de 
I'editeur Menu pour creer un nouveau menu ou editer un menu existant. 



Creation d'un 
nouveau menu 



Le chapitre 1 4 decrit 
I'ouverture d'un projet. 



Pour creer un nouveau menu : 

1. Verifiez que le projet auquel vous voulez ajouter un menu est ouvert. 
Vous pouvez choisir File I New Project pour creer un nouveau projet, ou 
File I Open Project pour ouvrir un projet existant. 

2. Lorsque vous avez ouvert un projet, choisissez Resource I New afin de 
creer une nouvelle ressource pour ce projet. La boite de dialogue New 
Resource apparait. 

3. Dans la boite de dialogue New Resource, faites defiler le contenu de la 
liste Resource Type jusqu'a MENU, puis double-cliquez sur MENU, ou 
bien cliquez sur MENU et OK. 

Resource Workshop affiche I'editeur Menu, avec un menu par defaut que 
vous pouvez editer. 
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Edition d'un menu Pour editer un menu existant, ouvrez le projet dans lequel le menu est 
existant stocke et executez une des procedures ci-dessous : 

■ Double-cliquez sur le nom de menu dans la fenetre projet. 

■ Mettez en surbrillance le nom de menu, puis choisissez Resource I Edit. 

Resource Workshop affiche l'editeur Menu, avec le menu choisi. 

Ecran de l'editeur Menu 

L'editeur Menu est divise en trois volets : un volet Outline similaire au 
script source, un volet Test Menu et un volet Attribute qui vous permet 
d'editer la ligne en surbrillance dans le volet Outline. Vous pouvez modifier 
la position des volets via la commande View (voir le tableau 16.1). 



Volet Attribute Le volet Attribute est l'endroit ou vous editez les commandes surgissantes 

et les elements de menu, affectez des valeurs d'identificateurs, et definissez 
des attributs pour vos menus et elements de menu. Vous pouvez egalement 
associer des raccourcis a chaque element de menu. L'instruction en cours 
d'edition apparait en surbrillance dans le volet Outline. Vos selections 
prennent effet lorsque vous executez une des etapes suivantes : 

■ Appuyez sur Entree pour entrer la modification. 

■ Appuyez sur Inser ou choisissez Menu I New Menu Item pour entrer la 
modification et inserer un nouvel element. 

■ Utilisez Cfrf+T, Ctrl+-l ou la souris pour deplacer le pointeur sur une autre 
instruction. 

■ Appuyez sur Ctrl+P ou choisissez Menu I New Pop-up pour inserer un 
nouveau menu surgissant. 

■ Appuyez sur Ctrl+S ou choisissez Menu I New Separator pour inserer un 
nouveau separateur. 

Les options du volet Attribute sont decrites dans le tableau 16.2. 



Volet Test Menu Le volet Test Menu affiche votre menu et vous permet de le tester. 

Le menu surgissant de la commande Pop-up par defaut contient une seule 
commande, appelee Item. L'editeur Menu actualise automatiquement ce 
menu test a mesure que vous modifiez le volet Outline. 
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Vous pouvez utiliser le menu View pour modifier le type d'affichage du 
menu test : a la fois sur la barre menu et relativement aux autres volets. 



Tableau 16.1 

Selections du menu 

View 



Selection menu Description 



View as Pop-up 










V 

























View as Pop-up, Controle si les commandes surgissantes,, dans le menu test,, sont affichees 
sur la barre menu ou dans un menu surgissant. 

Par defaut, cette option est desactivee, et les commandes surgissantes dans 
le menu test sont affichees sur la barre menu. Laissez cette option 
desactivee si votre ressource menu contient la structure de menu entiere de 
Implication, et que vous voulez I'afficher comme elle devrait apparaitre a 
I'utilisateur. 

Si vous travaillez sur un menu flottant,, activez cette option pour afficher le 
menu test tel qu'il devrait reellement apparaitre. La commande Pop-up 
apparait sur la barre menu. Selectionnez Pop-up pour afficher le menu 
lui-meme. 

First graphic Ce graphique represente la configuration par defaut des volets, avec le volet 

Test Menu au-dessus du volet Outline, et a droite du volet Attribute. 

Second graphic Activez ce graphique pour placer le volet Test Menu en haut de la fenetre 
d' edition, comme une barre menu normale. 



Volet Outline 



Le volet Outline affiche les commandes surgissantes, les elements de menu 
et les separateurs du nouveau menu en pseudocode. La ligne superieure du 
volet correspond au nom du menu. Les autres lignes sont des instructions 
qui definissent les menus surgissants et les elements de menu. Vous pouvez 
egalement afficher un TurboMenu : pointez sur le volet Outline et cliquez 
sur le bouton droit de la souris, ou appuyez sur Alt+F10 n'importe ou dans le 
volet. 

Le pseudocode du volet Outline est con<;u pour vous faciliter la tache avec la 
structure du menu. Pour consulter le code complet avec tous les parametres 
pour chaque instruction, editez le script ressource du menu (voir la section 
"Edition d'un script ressource menu" de ce chapitre). 

L'edition reelle du menu se fait dans le volet Attribute. Pour passer du volet 
Outline au volet Attribute, et vice-versa, appuyez sur F6. 
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Pour editer une instruction, selectionnez-la en executant une des operations 
ci-dessous : 

■ Appuyez sur Cf/7+T ou Ctrl+X. 

■ Choisissez un element de menu dans le volet Test Menu. 

■ Cliquez sur une ligne dans le volet Outline et appuyez sur F6. 

■ Appuyez sur T ou 4- dans le volet Outline, puis sur F6. 

Pour vous deplacer a l'interieur du volet Attribute, utilisez la souris pour 
positionner le pointeur a n'importe quel endroit et y faire des selections. 



Edition de menus 



Une fois le menu charge dans l'editeur Menu, vous pouvez commencer a 
ajouter de nouvelles commandes de menu, de nouveaux menus surgissants 
ou separateurs, a deplacer, copier ou supprimer toute partie du menu. 



Ajout de nouvelles 
Instructions 

Pour plus 

conformations sur 

I'ajout d'elements de 

menu, reportez-vous a 

la section "Ajout 

d'elements de menu et 

de separateurs" de ce 

chapitre. 



Pour ajouter une nouvelle instruction dans un menu (menu surgissant, 
element de menu ou separateur), placez le curseur dans la fenetre Outline 
sur la ligne precedant l'endroit ou vous voulez placer l'instruction. Pour 
inserer une instruction en premiere ligne, mettez en surbrillance la ligne du 
haut (MENU_1 ou le nom de la ressource menu). 

Lorsque vous aurez decide ou placer la nouvelle instruction et que vous 
aurez mis en surbrillance la ligne appropriee, vous pourrez ajouter une 
nouvelle instruction en choisissant une des commandes du menu Menu. 



Commande 



Effet 



New Pop-up 
New Menu Item 
New Separator 
New File Pop-up 
New Edit Pop-up 

New Help Pop-up 

La commande Check 
Duplicates 



insere un nouveau menu surgissant avec un seul element. 

insere un element. 

insere un separateur. 

ajoute un menu File (Fichier) generique complet. 

ajoute un menu Edit, avec les commandes Cut (Couper), Copy 
(Copier) et Paste (Coller). 

ajoute un menu Help (Aide) predefini. 

est decrite a la section "Test des menus". 
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Si vous voulez ajouter une commande surgissante qui apparaitra en 
premiere position dans la barre menu (position generalement occupee par le 
menu File), mettez en surbrillance la premiere ligne du volet Outline 
(MENU_1 ou le nom de la ressource menu). 



Ajout d'elements 
de menu et de 
separateurs 



Pour ajouter un element ou un separateur dans un menu : 

1. Choisissez la position du nouvel element ou separateur dans le menu et 
mettez en surbrillance dans le volet Outline la ligne qui precede cette 
position (l'editeur Menu insere le nouvel element ou separateur sous la 
ligne en subrillance). 

2. Appuyez sur INS ou choisissez Menu I New Menu Item. 

3. Tapez le nom du nouvel element ou separateur. 

4. Appuyez sur Entree 

Vous pouvez egalement ajouter trois menus par defaut a votre projet : 

■ Menu I New file pop-up ajoute le menu File comme premiere commande 
menu (extremite gauche de la barre menu). Le nouveau menu File 
contient les commandes New, Open, Save, Save As, Print, Page Setup, 
Printer Setup et Exit. 

■ Menu I New edit pop-up ajoute le menu Edit en deuxieme position (de la 
gauche vers la droite) dans la barre menu. Le nouveau menu Edit contient 
les commandes Undo, Cut, Copy et Paste. 

■ Menu I New help pop-up ajoute le menu Help comme derniere commande 
menu (extremite droite de la barre menu). Le nouveau menu Help 
contient les commandes Index, Keyboard, Commands, Procedures, Using 
help et About. 



Edition des Un nouveau element de menu ajoute a la designation generique "Item", 

elements de menu Pour le rendre plus comprehensible, vous devez l'editer. 

Le premier element de menu ajoute est automatiquement selectionne, et 
vous pouvez l'editer immediatement. Par contre, si vous ajoutez d'autres 
elements de menu, vous devez d'abord selectionner un element de menu 
avant de pouvoir l'editer. 



Utilisation du volet 
Attribute 



Dans le volet Attribute, utilisez la souris, la touche Tab ou la touche Maj.+Tab 
pour positionner le pointeur sur le champ a editer. 

Le tableau suivant decrit les selections disponibles dans le volet Attribute. 
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Tableau 16.2 

Selections du volet 

Attribute de I'editeur 

Menu 



Selection 



Description 



Item Text Le nom d'un menu surgissant ou d'un element de menu 

(commande), et une description facultative de son raccourci, le cas 
echeant. 

Item help Une chaine qui decrit I'element de menu. Ce texte est stocke dans la 

table de chaines de votre projet (si vous n'avez pas defini de table 
de chaines pour votre projet, le systeme en ajoute une lorsque vous 
utilisez cette option). Le texte entre ici peut servir de ligne d'aide 
affichable dans une barre d'etat. 

Item ID Un identificateur unique pour un element de menu. Cette boite de 

saisie n'est pas disponible lorsqu'un menu surgissant ou un 
separateurde menu est selectionne. 

Item Type Menu surgissant, element de menu ou separateur de menu. 

Break Before Controle le format des commandes menu dans la barre menu ou 

dans les menus surgissants. Choisissez une des options suivantes : 

- No Break Pas d'interruption avant cette commande. 

- Menu Bar Break Commence une nouvelle ligne dans la barre menu. Dans un menu 

surgissant, commence une nouvelle colonne et dessine une ligne 
verticale pour separer les colonnes. 

- Menu Break Commence une nouvelle ligne dans la barre menu ou une nouvelle 

colonne dans un menu surgissant. 

- Help Break Deplace I'element de menu ou la commande surgissante jusqu'a 

I'extreme droite de la barre menu. Utilisez cette option uniquement 
avec des instructions de niveau superieurqui s'affichent dans la 
barre menu. 

Initial state $IMenu (editeur);options Initial StateControle I'etat initial de I'element 

de menu. Choisissez I'une des options suivantes : 

- Enabled Dans son etat initial, la commande est activee. Utilisez la fonction 

EnableMenultem pour changer I'etat de I'element de menu. 

- Disabled Dans son etat initial, la commande est desactivee. L'utilisateur ne 

peut differencier les commandes Enabled et Disabled sur le menu. 
Utilisez la fonction EnableMenultem pour changer I'etat de I'element 
de menu. 

- Grayed Dans son etat initial,, la commande est desactivee et son texte 

apparait en grise. Ceci indique a l'utilisateur que la commande n'est 
pas actuellement disponible. Utilisez la fonction EnableMenultem 
pour changer I'etat de I'element de menu. 

- Checked Place une coche a cote de la commande. Choisissez cette option si 

I'element est une bascule et si vous souhaitez que la commande 
apparaisse initialement avec une coche. Utilisez la fonction 
CheckMenultem pour changer I'etat de la commande. 
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Tableau 5.2 

Selections du volet 

Attribute de I'editeur 

Menu (suite) 



Selection 



Description 



Key 
Modifiers 

- Alt 

- Shift 

- Control 

- Invert 



Key type 
- ASCII 



Virtual key 



Specifie la deuxieme touche de raccourci associee a un element de 
menu. Choisissez I'une des options suivantes : 

Le raccourci est une combinaison de touches avec Alt (par exemple, 
Alt+W) et autres. 

Le raccourci inclut la touche Maj. (par exemple, Maj.+F1). 

Le raccourci inclut la touche Ctrl (par exemple, Ctrl+FS}. 

Desactive la fonction de clignotement (inversion video momentanee), 
fonction interne de Windows qui fait clignoter la commande associee 
au raccourci ; I'utilisateur peut ainsi identifier le menu qui contient le 
raccourci. Lorsque vous creez un raccourci 

Decrit le type de raccourci associe a un element de menu. 
Choisissez I'une des options suivantes : 

Le raccourci est une touche ASCII standard (les touches ASCII 
doivent etre placees entre guillemets). Le caret ( A ) indique que la 
touche est combinee avec la touche Ctrl. En general, les caracteres 
ASCII ne s'utilisent pas seuls pour les raccourcis 

Une "touche virtuelle" est une touche de fonction, une touche flechee 
ou une touche d'edition telle que Home ou End. Pour ces touches 
virtuelles 



Saisie du texte de 
I'element 



Le texte de I'element est le nom de menu ou la commande qui apparait dans 
la barre menu ou dans le menu. Lorsque la selection Item Text apparait en 
surbrillance, vous pouvez taper une nouvelle chaine texte directement dans 
la boite. Vous pouvez aussi utiliser les touches Origine Fin et les touches 
flechees pour deplacer le curseur dans la boite de saisie. 

Si vous voulez que I'utilisateur puisse choisir le menu ou la commande en 
tapant une lettre dans le nom de menu ou de commande, placez un symbole 
& immediatement devant cette lettre. Windows affichera le texte avec cette 
lettre soulignee. 
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Voir le chapitre 17 pour 

plus d'informations sur 

les raccourois. 



Pour lier le raccourci Ctrl+F4 a la nouvelle commande Stored Order, ajoutez 
le texte du raccourci a vos menus. 

■ Utilisez le caractere de tabulation (\t) pour separer le titre de menu du 
texte de raccourci par une tabulation (par exemple, & Stored 
Order\tCtrl+F4). 

■ Utilisez le caractere d'alignement a droite (\a) pour aligner a droite le 
texte du raccourci (par exemple, Stored 0rder\aCtrl+F4). 

Les applications Windows utilisent generalement le signe plus pour montrer 
des combinaisons de touches, telles que Maj. +Suppr ou Ctrl+Maj.+F4. 



Saisie des 

identificateurs 

d'elements 



Pour plus de details, 

reportez-vous au 

chapitre 14 



Tous les elements de menu doivent etre identifies de facon unique. Lorsque 
vous ajoutez un nouvel element, Resource Workshop affecte 
automatiquement un identificateur, different des autres identificateurs 
d'element de cette ressource menu. Vous pouvez accepter cette valeur, ou 
bien la remplacer par un autre nom ou numero unique. 

Si vous tapez un nom, Resource Workshop verifie si un identificateur de ce 
nom existe. Si ce n'est pas le cas, une boite de dialogue vous demande si 
vous voulez creer un identificateur. Cliquez sur OK. Si vous voulez utiliser 
le nom en tant qu'identificateur d'element, vous devez creer un 
identificateur. A partir de la, creez le nouvel identificateur comme specifie a 
la section "Ajout d'identificateurs" du chapitre 14. 



Deplacement et 
copie constructions 



Vous pouvez utiliser les options Cut, Copy et Paste du menu Edit pour 
deplacer et copier les instructions dans le volet Outline de l'editeur Menu. 

Pour deplacer une instruction, mettez-la en surbrillance et choisissez 
Edit I Cut. Notez que vous ne pouvez pas couper la derniere (ou la seule) 
instruction du volet Outline. II doit toujours y avoir au moins un element de 
menu, une commande surgissante ou un separateur de menu dans le volet 
Outline. Pour inserer l'instruction coupee ou copiee dans votre menu, 
mettez en surbrillance l'instruction situee immediatement devant le point 
d'insertion, et choisissez Edit I Paste. 

Pour copier une instruction, mettez-la en surbrillance et choisissez 

Edit I Copy. L'instruction en surbrillance reste dans le volet Outline, et une 

copie est placee dans le presse-papiers. 
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Suppression 
constructions de 
menu 



Creation de menus 
flottants 



Mettez en surbrillance l'instruction a supprimer, puis appuyez sur Suppr ou 
choisissez Edit I Delete pour la supprimer. Vous pouvez aussi choisir 
Edit I Cut pour supprimer l'instruction et la copier dans le presse-papiers. 

Notez les points suivants a propos de la suppression d'instructions de 
menu : 

■ Si vous supprimez une instruction POPUP, la commande surgissante 
qu'elle definit et tous les elements contenus dans le menu surgissant sont 
aussi supprimes. 

■ Vous ne pouvez pas supprimer les instructions _End Popup_. 

■ Vous ne pouvez pas supprimer la derniere (ou la seule) instruction du 
volet Outline. II doit toujours y avoir au moins un element de menu, une 
commande surgissante ou un separateur de menu dans le volet Outline. 

Un menu flottant peut s'afficher n'importe ou dans l'espace fenetre de 
l'application. II n'est pas lie a une barre menu. 

Chaque menu flottant doit etre enregistre comme une ressource menu 
distincte a l'interieur du fichier projet. 

Pour creer un menu flottant : 

1. Choisissez Resource I New et selectionnez Menu a partir de la boite de 
dialogue New Resource. 

2. Choisissez View I View as Pop-up pour voir le menu flottant tel qu'il 
apparaitra a l'ecran pendant l'execution. 

Lorsque vous visualisez le menu dans le volet Test Menu, il semble 
toujours attache a la barre menu, mais tant que votre code utilise 
correctement la fonction TrackPopupMenu, le menu sera flottant pendant 
l'execution. 

3. Selectionnez la premiere ligne du volet Outline (MENU_1 ou le nom de 
la ressource menu). 

4. Appuyez sur la touche Inser pour ajouter au moins un element de menu 
en tete du volet Outline. 

5. Selectionnez la chaine POPUP "Pop-up" dans le volet Outline. 

6. Appuyez sur la touche Suppr pour supprimer l'instruction POPUP, son 
element de menu et l'instruction _End Popup_. 

7. Ajoutez d'autres elements de menu. 
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8. Editez les elements de menu dans le volet Attribute. 

9. Enregistrez votre projet. 



Test des menus 



L'editeur Menu permet de tester immediatement les modifications 
apportees ; le menu est modifie en temps reel, et vous pouvez l'afficher a 
tout moment pour juger de son apparence. Lorsque vous choisissez un 
element de menu, ce dernier s'affiche en surbrillance dans le volet Outline, 
et ses proprietes apparaissent dans le volet Attributes. (Vous pouvez 
annuler cette fonction en desactivant Menu I Track test menu. 

L'editeur Menu comprend aussi un outil de deboguage integre que vous 
pourrez utiliser pour rechercher les identificateurs d'element de menu en 
double. Si vous choisissez Menu I Check Duplicates, l'editeur Menu 
recherche les doublons et affiche, le cas echeant, une boite de dialogue avec 
le message "Duplicate command value found". 

Une fois la boite de messages refermee, l'editeur Menu met en surbrillance 
l'instruction qui contient ce doublon. Vous devez executer une des 
procedures suivantes : 

■ Si l'identificateur d'element est un nombre, entrez un nouveau nombre 
qui n'entre pas en conflit avec les autres identificateurs d'element. 

■ Si l'identificateur d'element est une chaine, la boite Item ID contient une 
chaine texte, et la boite situee a droite de Item ID contient un nombre. 
Pour changer la valeur d'identificateur, 

1. Choisissez Resource I Identifiers pour afficher la boite de dialogue 
Identifiers. 



Pour voir l'identificateur 

de menu dans votre 

ressource, choisissez 

Resource I Edit as Text. 



2. Faites defiler la liste des identificateurs jusqu'a celui que vous recherchez. 

3. Cliquez sur le bouton Change et tapez une nouvelle valeur qui n'entre 
pas en conflit avec les autres identificateurs d'element. 

4. Cliquez sur OK ou appuyez sur Entree pour modifier la valeur. 

5. Cliquez dans la fenetre de l'editeur Menu pour poursuivre 1' edition de 
votre menu. Vous pouvez aussi laisser la boite de dialogue Identifiers 
ouverte pour une prochaine utilisation. 
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Par exemple, si vous affectez la valeur 101 a deux identificateurs wmnuJList 
et wmnu_Asc, l'option Menu I Check Duplicates genere le message 
"Duplicate command value found" et l'editeur Menu met wmnu_Asc en 
surbrillance (le second des deux identificateurs). Comme specif ie plus haut, 
vous devrez changer la valeur de wmnu_Asc par une valeur differente de 
101, 102 ou 104 (les valeurs des autres identificateurs du menu). 



Edition de scripts ressource menu 



Voir I'index de I'aide en 

ligne pour la description 

des options de script 

ressource pour les 

menus. 



Vous pouvez aussi 

effectuerces 

modifications en 

choisissant 

Resource j Memory 

Options. 



Pour travailler avec le script ressource d'un menu, selectionnez le nom du 
menu de la fenetre projet en le cliquant. Choisissez ensuite Resource I Edit 
As Text pour afficher le script ressource dans l'editeur de texte interne. 

Pour editer, par exemple, le script ressource du menu exemple que vous 
creerez dans la prochaine section, vous pouvez ouvrir le projet qui contient 
ce menu, puis mettre le menu en surbrillance et choisir Resource I Edit As 
Text. Resource Workshop ouvre son editeur de texte interne et affiche les 
codes source comme suit : 

MENU_1 MENU 
BEGIN 

POPUP "SWidgets" 
BEGIN 

MENUITEM "&List\tCtrl+L", wmnu_List 
MENUITEM "SAdd. . . \tCtrl+A", wmnu_Add 
MENUITEM SEPARATOR 
POPUP "A&rrange List" 
BEGIN 

MENUITEM "&Ascending\tCtrl+F2", wmnu_Asc 
MENUITEM "&Descending\tCtrl+F3", wmnu_Desc 
END 
END 
END 

Utilisez l'editeur pour modifier directement le script ressource. Par exemple, 
pour changer les deux options memoire de menu LOADONCALL et 
MOVEABLE (valeurs par defaut) en PRELOAD et FIXED : 

1. Dans l'editeur de texte, modifiez la premiere ligne du script comme suit : 

MENU_1 MENU PRELOAD FIXED 

2. Pour compiler votre saisie actuelle et verifier si elle est correcte, 
choisissez Compile I Compile Now. 
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Le menu Compile est uniquement disponible dans l'editeur de texte. Si 
vous retournez a l'editeur Menu, puis choisissez Resource I Edit as Text 
pour basculer a nouveau dans l'editeur de texte, Resource Workshop 
insere une option memoire par defaut dans le script. La premiere ligne 
du script devient : 

MENU_1 MENU PRELOAD FIXED DISCARDABLE 

3. Si vous voulez quitter l'editeur Menu, choisissez la commande Close 
dans la boite Control-menu de la fenetre de l'editeur de texte. Resource 
Workshop vous invite a compiler. Si vous cliquez sur Yes, Resource 
Workshop compile le menu et active la fenetre projet. 

Ne perdez pas votre temps en inserant des commentaires dans votre script 
ressource, ou enformatant le texte. En effet, le compilateur incremental de Resource 
Workshop execute son propre formatage et abandonne tous les commentaires. 



Exemple de menu 



Cette section vous explique comment creer le menu surgissant simple 
Widgets avec l'editeur Menu. 



Figure 16.1 
Menu exemple 



a 


TEST MENU: MENLM 




List 
Add... 


Ctrl+L 
Ctrl+A 




Arrange List 


Ascending Ctrl+F2 ^^^^^^^^| 




Descending Ctrl+F3 





Les deux premieres commandes du menu (List et Add) vous permettent 
d'observer une liste d'objets existants, ou d'ajouter de nouveaux objets. La 
troisieme commande, Arrange List, genere un menu surgissant avec deux 
commandes supplementaires (Ascending et Descending) utilisees pour 
choisir l'ordre de tri de la liste d'objets. 

Widgets et Arrange List sont des commandes surgissantes. Widgets affiche 
le menu Widgets, et Arrange List affiche le menu en cascade qui contient les 
commandes Ascending et Descending. 
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List, Add, Ascending et Descending sont des elements (ou commandes) de 
menu. Si l'utilisateur clique sur une de ces commandes, l'application execute 
une action. Les points de suspension (...) situes apres la commande Add 
signifie que l'application affiche une boite de dialogue lorsque l'utilisateur 
choisit cette commande. Notez le separateur menu qui separe les 
commandes List et Add de la commande surgissante Arrange List. 



Creation du menu 
exemple avec 
I'editeur Menu 



Voir le chapitre 14 pour 
plus d'informations sur 
I'ouverture d'un projet. 



Grace a certaines fonctions de I'editeur Menu, la creation du menu exemple 
est plus facile que sa creation avec I'editeur de texte. En outre, I'editeur 
Menu gere les identificateurs de menu et les memorise dans un fichier 
d'identificateurs distinct, si vous en avez cree un. De plus, vous pouvez 
tester le menu au fur et a mesure de sa creation. 

Pour creer le menu exemple : 

1. Verifiez si vous avez deja ouvert un projet. 

2. Lorsque le projet est ouvert, choisissez Resource I New. 

3. Resource Workshop affiche la boite de dialogue New Resource. Faites 
defiler la liste Resource Type jusqu'a MENU, puis double-cliquez. 

Resource Workshop ajoute une nouvelle ressource menu a la fenetre 
projet. Ensuite, il affiche le nouveau menu dans I'editeur Menu et la 
premiere instruction du volet Outline (POPUP "Pop-up") apparait en 
surbrillance. 

4. Pour renommer l'instruction initiale du menu (de Pop-up a Widgets), 
tapez &Widgets dans la boite de saisie Item Text du volet Attribute, et 
appuyez sur Entree. 

L'editeur Menu actualise a la fois les volets Menu Test et Outline. 



Dans le menu test, notez que le W de Widgets est souligne. Vous pourrez 
done appuyer sur Alt+W pour afficher le menu Widgets. 



Ajout de 
commandes au 
menu Widgets 



Ajoutez ensuite les commandes au menu Widgets. 

1. Pour renommer le premier element de menu et ajouter le texte du 
raccourci, appuyez sur Ctrl+X pour mettre en surbrillance la deuxieme 
ligne du volet Outline (MENUITEM "Item"), et tapez &List\tCtrl+L 
dans la boite de saisie Item Text. 
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2. Tabulez jusqu'a la boite de saisie Item ID et tapez wmnu_Li st pour 
entrer l'identificateur de cette commande. Appuyez sur Entree. 

Resource Workshop vous demande si vous souhaitez creer un nouvel 
identificateur. Appuyez sur Entree pour afficher la boite de dialogue New 
Identifier, puis a nouveau sur Entree pour accepter la valeur affichee. 

A ce stade, vous devriez ouvrir l'editeur Accelerator pour creer la touche 
raccourcie Ctrl+L Neanmoins, nous executerons cette procedure a la 
section "Creation d'un exemple de table de raccourcis" du chapitre 
suivant, car nous n'avons pas encore traite les raccourcis. 

3. Avec la commande List en surbrillance, ajoutez une nouvelle commande 
menu en appuyant sur Inser ou en choisissant Menu I New Menu Item. 

4. Tapez &Add. . . \tCtrl+A dans la boite Item Text pour modifier letexte 
du nouvel element de menu. 

5. Creez un identificateur pour l'element. Pour cela, appuyez sur la touche 
Tab pour selectionner le champ Item ID, tapez wmnu_Add, appuyez sur 
Entree, et repondez aux messages comme precedemment. 

6. Appuyez sur Ctrl+S pour placer un separateur apres la commande Add. 

7. Avec la commande Add en surbrillance, appuyez sur Ctrl+P pour ajouter 
un nouveau menu surgissant. Changez le texte en A&rrange List. 

Puisque vous voulez que des commandes supplementaires apparaissent 
lorsque l'utilisateur choisit Arrange List, definissez-la en tant que 
commande surgissante et non comme un autre element de menu. Une 
commande surgissante au milieu d'un menu cree un menu en cascade. 



Ajout de Pour definir les deux commandes menu dans le menu surgissant Arrange 

commandes au Tj s t . 



menu Arrange List 



1. Appuyez sur Ctrl+X jusqu'a ce que le premier element du menu Arrange 
List apparaisse en surbrillance. 

2. Changez l'element de menu de "Item" a "&Ascending\tCtrl+F2". 

3. Creez l'identificateur wmnu_Asc pour cette commande. 

4. Appuyez sur Inser pour ajouter un nouvel element de menu apres 

"& Ascending", puis renommez-le en "&Descending\tCtrl+F3". 

5. Creez l'identificateur wmnuJDesc pour cette commande. 

6. Enregistrez le projet. 
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Test du menu Testez le menu en cliquant sur la commande Widgets dans le volet Test 

Menu, et en faisant glisser le pointeur jusqu'a la commande Arrange List. 
Votre menu doit ressembler a celui de la figure 16.1, au debut de ce chapitre. 

Vous pouvez aussi verifier les doublons des identificateurs de menu en 
choisissant Menu I Check Duplicates. 

■ S'il n'existe aucun doublon, le message "No duplicates found" s'affiche. 

■ S'il existe des doublons, le message "Duplicate command value found" 
s'affiche. La section "Tester des menus" de ce chapitre vous indique la 
procedure de correction des valeurs en double. 



322 Borland C++ Guide de I'utilisateur 



17 



Creation de raccourcis 



Voir la section 
"Creation d'un exemple 
de table de raccourcis" 
pour illustrer I'utilisation 
de I 'editeur Accelerator. 



Un mccourci est une combinaison de touches sur laquelle l'utilisateur appuie 
pour executor une tache. II remplace une commande menu et genere un 
message WM_COMMAND ou WM_SYSCOMMAND. 

En general, vous creez des raccourcis pour dupliquer des commandes sur 
des menus surgissants. Si vous ouvrez le menu Edition dans la plupart des 
applications Windows, vous voyez les raccourcis suivants : Alt+Retour arriere 
(Annuler), Maj+Suppr (Couper), Ctrl+lnser (Copier) et iMa/'+/nse/'(Coller). 

Vous memorisez les definitions des raccourcis dans une table de raccourcis 
(ressource du raccourci). Chaque entree de la table est un raccourci qui 
definit la combinaison de touches et la commande generee. Vous pouvez 
creer plusieurs tables de raccourcis (ou ressources) pour differentes parties 
de votre menu. 

Resource Workshop vous propose l'editeur Accelerator specialement prevu 
pour creer et editor les raccourcis de votre application. Lorsque vous 
travaillez avec les raccourcis, vous executez cinq taches essentielles : 

1. Lancer l'editeur Accelerator. 

2. Lancer l'editeur Menu, de facon a definir des raccourcis correspondant a 
des elements de menu. 

3. Creer ou editor une table de raccourcis. 

4. Verifier la presence de doublons dans la table de raccourcis. 

5. Enregistrer la table de raccourcis. 

Si vous ouvrez le projet demo (RWCDEMO.RC ou RWPDEMO.RC) et 
double-cliquez sur la ressource Accelerator, Resource Workshop affiche la 
table de raccourcis. 
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Combinaisons de touches de la table des raccourcis 

Les combinaisons de touches de votre table de raccourcis peuvent utiliser 
des touches ASCII ou des touches virtuelles. 

■ Une touche ASCII est une touche affichable : generalement un caractere 
alphanumerique ou un symbole de ponctuation. 

■ Une touche virtuelle est une touche de fonction, une touche flechee ou une 
touche d'edition, telle que Origine ou PgSuiv. Bien que, dans certains cas, ces 
touches puissent afficher des caracteres a l'ecran, aucun standard ne 
specifie les caracteres qui apparaissent. 



Touches ASCII 



Touches virtuelles 



Toutes les touches ASCII doivent etre entourees par des guillemets. Le 
symbole A signifie que la touche est combinee a la touche Ctrl. La case a 
cocher Alt du volet Attribute specifie si la touche est combinee a la touche Alt. 

Par exemple, les combinaisons de touches Ctrl+Wet Ctrl+Alt+W sont 
representees dans le volet Outline par " A W", mais une coche est presente dans 
la case a cocher Alt du volet Attribute pour Ctrl+Alt+W. 

En principe, n'utilisez pas un caractere ASCII unique comme touche de 
raccourci. Vous devez plutot le combiner avec la touche Alt ou Ctrl (Ctrl+L ou 
Alt+L au lieu du L tout seul). 

Windows a des identificateurs predefinis pour les touches virtuelles, tels 
que VK_BACK pour Retour arriere et VK_F1 pour F1. Ces identificateurs, 
commencant tous par VK_, sont definis dans WINDOWS.H. 

Les cases a cocher Modifiers du volet Attribute specifient si la touche est 
combinee a Ctrl, Alt, Maj ou a toute combinaison des trois. 

Par exemple, vous pourriez avoir deux raccourcis VK_F1 dans votre table. 
Le premier raccourci pourrait etre Ctrl+F1 (case a cocher Control activee), et 
le second raccourci Maj+F1 (case a cocher Shift activee). 

Vous n'aurez pas besoin de rechercher ces identificateurs de touche virtuelle 
si vous utilisez le mode Key Value pour inserer la touche (voir la section 
"Mode Key Value" plus loin dans ce chapitre), car l'editeur Accelerator 
prend la valeur correcte et l'insere a votre place. 



324 



Borland C++ Guide de I'utilisateur 



Lancement de I'editeur Accelerator 



La procedure de lancement de I'editeur Accelerator est differente selon que 
vous creez une nouvelle table de raccourcis ou modifiez une table existante. 



Pour creer une 
nouvelle table de 
raccourcis 



Voir le chapitre 14 pour 
plusd'informationssur 
I'ouverture d'un projet. 



Pour editer une 
table de raccourcis 
existante 



Vous pouvez creer une nouvelle table de raccourcis dans un nouveau projet 
ou dans un projet existant. 

Pour lancer I'editeur Accelerator et creer une nouvelle table de raccourcis : 

1. Choisissez File I New Project pour creer un nouveau projet ou 
File I Open Project pour ouvrir un projet existant. 

2. Choisissez Resource I New pour afficher la boite de dialogue New 
Resource. 

3. Dans la boite de dialogue New Resource, double-cliquez sur 
ACCELERATOR dans la liste Resource Type. 

Resource Workshop affiche I'editeur Accelerator avec un modele de table de 
raccourcis que vous pouvez editer. 

Pour lancer I'editeur Accelerator et editer une ressource raccourci existante, 
ouvrez le projet dans lequel la ressource est memorisee et executez une des 
procedures suivantes : 

■ Double-cliquez sur le nom de la ressource raccourci dans la fenetre projet. 

■ Mettez en surbrillance le nom de la ressource raccourci dans la fenetre 
projet, et choisissez Resource I Edit. 

Resource Workshop affiche I'editeur Accelerator avec la table de raccourcis 
chargee. 



Execution de 
I'editeur Menu en 
meme temps 



Lorsque vous travaillez avec des raccourcis, il est preferable de lancer 
I'editeur Menu et de charger le menu contenant les commandes associees. 
De cette facon, vous pouvez voir le texte de commande et les identificateurs 
d'element dont vous aurez besoin lors de la definition des raccourcis. 
Comme explique a la section "Parametrage de la valeur de commande" plus 
loin dans ce chapitre, chaque raccourci doit avoir un identificateur qui 
correspond a une commande du menu. 
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Pour de plus amples informations sur l'ajout de raccourcis a vos menus, 
reportez-vous aux sections "Saisie du texte de l'element" et "Ajout de 
commandes au menu Widgets" du chapitre 16. 



Comment utiliser I'editeur Accelerator 



L'ecran de I'editeur Accelerator est divise en deux volets : le volet Outline et 
le volet Attribute. Vous pouvez vous deplacer d'un volet a un autre avec la 
souris ou la touche F6. 



Volet Outline 



Voir la section 

"Combinaisons de 

touches de la table des 

raccourcis" pour plus 

de details sur les 

touches ASCII et 

virtuelles. 



Le volet Outline affiche, sous la forme script, tous les raccourcis definis dans 
la table. La ligne du haut de ce volet correspond au nom de la table de 
raccourcis. Les lignes au-dessous sont les entrees de raccourcis, comprenant 
deux parties : 

■ La premiere partie identifie la touche utilisee en tant que raccourci. II 
s'agit soit d'une touche ASCII, soit d'une touche virtuelle. 

■ La seconde partie est l'identificateur d'element de la commande associee 
au raccourci. Cet identificateur est soit un entier, soit un nom. 

Pour selectionner un raccourci dans le volet Outline, utilisez la souris ou 
les touches flechees (vous pouvez egalement afficher un TurboMenu : 
pointez sur le volet Outline et cliquez sur le bouton droit de la souris, ou 
appuyez sur Alt+FlO n'importe ou dans le volet). 



Volet Attribute 



En selectionnant un raccourci du volet Outline, vous pouvez lire ses 
parametres dans le volet Attribute. Lorsqu'un raccourci est selectionne, vous 
pouvez effectuer des changements dans le volet Attribute, tels que specifier 
une nouvelle combinaison de touches, ou associer le raccourci a une autre 
commande. 

A partir du volet Attribute, utilisez la souris ou appuyez sur Cfrf+T ou Ctrl+i 
pour selectionner un raccourci. 

Utilisez la souris pour vous deplacer a l'interieur du volet Attribute et y 
faire des selections. En outre, vous pouvez utiliser les touches suivantes : 

■ Tab effectue un deplacement vers l'avant dans le volet Attribute, et Maj+Tab 
vers l'arriere. Notez que chaque case a cocher Modifiers est un taquet de 
tabulation. 
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Si vous tabulez a partir de la boite de saisie Command vers la boite de 
saisie Key, l'editeur Accelerator passe au mode Key Value. Dans ce mode, 
vous pouvez appuyer sur toute touche pour entrer le raccourci. Pour sortir 
de ce mode, cliquez sur la souris ou appuyez sur Alt+Echap. Le mode Key 
Value est decrit a la section "Mode Key Value" de ce chapitre. 

■ Les touches flechees effectuent une selection parmi les boutons radio Key 
Type, et la barre d'espacement bascule l'etat des cases a cocher Modifiers. 

Vos selections sont validees lorsque vous appuyez sur Entree (pour modifier 
le raccourci) ou Inser (pour creer un nouveau raccourci), ou encore lorsque 
vous vous deplacez jusqu'a un autre raccourci dans le volet Outline. 

Le tableau suivant decrit les selections que vous pouvez faire dans le volet 
Attribute. 



Tableau 17.1 

Selections dans le 

volet Attribute de 

l'editeur Accelerator 



Selection Description 

Command Identificateur d'element (entier ou nom) pour la commande executee par le 

raccourci. Cette valeur doit correspondre a la valeur dans la ressource menu 
associee. 

Key Touche de raccourci. Vous pouvez entrer la touche en mode manuel (avec 

des guillemets pour les touches ASCII et la syntaxe appropriee pour les 
touches virtuelles), ou en mode Key Value (l'editeur Accelerator decide s'il 
s'agit d'une touche ASCII ou d'une touche virtuelle, et la rentre a votre place 
dans le format approprie). Si vous tabulez dans cette boite de saisie a partir 
de la boite de saisie Command, vous passez automatiquement en mode Key 
Value. Reportez-vous a la section "Mode Key Value" de ce chapitre pour 
obtenir la description du mode Key Value. 

Key Type Touche ASCII ou virtuelle. En mode Key Value, l'editeur Accelerator definit 

automatiquement ces boutons radio. 

- ASCII Le raccourci utilise une touche ASCII (voir la section "Touches ASCII" de ce 

chapitre). 

- Virtual Key Le raccourci utilise une touche virtuelle (voir la section "Touches virtuelles" de 

ce chapitre). 
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Tableau 17.1 

Selections dans le 

volet Attribute de 

I'editeur Accelerator 

(suite) 



Selection 



Description 



Modifiers Les descriptions suivantes de ces cases a cocher detaillent I'option si elle est 

activee. 

- Alt Le raccourci inclut la touche 4/f (par exemple, 4/f+lV). 

- Shift Le raccourci inclut la touche Maj (par exemple, Maj+F1). 

- Ctrl Le raccourci inclut la touche Ctrl (par exemple, Ctrl+F3). 

- Invert Menu Item Si vous utilisez le raccourci, la commande de la barre menu associee clignote 

(inversion momentanee). 



Edition d'une table de raccourcis 



Une fois la table de raccourcis chargee dans I'editeur Accelerator, vous 
pouvez l'editer. Grace a cet editeur, vous pouvez definir et modifier les 
raccourcis, ou specifier une combinaison de touches de raccourci en vous 
contentant d'appuyer sur la combinaison souhaitee. Vous pouvez aussi 
copier ou supprimer tout raccourci dans la table, et verifier s'il existe des 
valeurs d'identificateur en double. 



Ajout d'un 
raccourci 



Pour ajouter un nouveau raccourci dans la table de raccourcis, appuyez sur 
Inser ou choisissez Accelerator I New Item. La nouvelle touche apparait 
dans le volet Outline sous la ligne actuellement selectionnee, avec comme 
valeurs par defaut : (zero) pour la valeur de touche et une valeur entiere 
unique pour l'identificateur de commande. 

Lorsque vous ajoutez un nouveau raccourci, l'edition bascule dans le volet 
Attribute. 



Selection d'un 
raccourci 



Pour selectionner un raccourci, executez une des procedures suivantes : 

■ Appuyez sur Cfrf+T ou Ctrl+-l pour mettre en surbrillance le raccourci dans 
le volet Outline, et basculer automatiquement l'edition vers le volet 
Attribute. 

■ Cliquez sur le raccourci dans le volet Outline, puis appuyez sur F6 pour 
basculer automatiquement l'edition vers le volet Attribute. 

■ Si le pointeur se trouve deja dans le volet Outline, utilisez les touches 
flechees pour selectionner le raccourci, puis appuyez sur F6 pour basculer 
automatiquement l'edition vers le volet Attribute. 
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Comment utiliser le 
volet Attribute 



Le volet Attribute a des boites de saisie, des boutons radio et des cases a 
cocher qui definissent le raccourci. Les options du volet Attribute sont 
decrites dans le tableau 17.1. 



Parametrage de la 

valeurde 

commande 



Specification du 
raccourci 



Dans la boite de saisie Command, tapez l'identificateur d'element (un entier 
ou un nom) pour la commande executee par le raccourci. 

La chaine Command est automatiquement mise en surbrillance lorsque 
vous selectionnez un raccourci avec Cfrf+T ou Ctrl+X, ou ajoutez un raccourci 
avec Ins. Tapez l'identificateur d'element directement dans la boite de saisie. 

Si vous liez le raccourci a une commande d'un menu existant, lancez 
l'editeur Menu et chargez la ressource menu. Notez l'identificateur 
d'element de la commande et utilisez ce meme identificateur dans la boite 
de saisie Command du raccourci. 

Notez les points suivants a propos des identificateurs : 

■ Si vous entrez un nom d'identificateur existant et que vous voyez la boite 
de dialogue "Create a new identifier:", vous avez probablement commis 
une erreur. Cliquez sur No et verifiez le nom. 

■ Si vous entrez volontairement un nouvel identificateur pour ajouter 
ulterieurement l'element de menu associe au menu, Resource Workshop 
vous invite a creer un nouvel identificateur. Cliquez Yes ou appuyez sur 
Entree, puis entrez une valeur d'identificateur unique dans la boite de 
dialogue New Identifier. 

Si vous n'obtenez pas la boite de dialogue "Create a new identifier", 
l'identificateur existe deja. Entrez un identificateur unique avant de 
poursuivre. 

Pour specifier la combinaison de touches, entrez la combinaison dans la 
boite de saisie Key. 

Votre raccourci doit etre compatible avec les raccourcis des autres 
applications Windows. N' utilisez done pas une combinaison de touches 
Windows (comme Ctrl+Echap). Pour obtenir des conseils sur le choix des 
combinaisons de touches appropriees, reportez-vous au Systems Application 
Architecture Common User Access Advanced Interface Design Guide de IBM. 

Vous pouvez utiliser le mode manuel ou le mode Key Value pour entrer la 
touche. 
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Mode Key Value : En mode Key Value, toute touche ou combinaison de 
touches frappee est automatiquement entree dans la boite de saisie Key 
comme raccourci. L'editeur Accelerator determine si la touche est une 
touche ASCII ou une touche virtuelle, et selectionne le bouton radio Key 
Type approprie. L'editeur Accelerator active aussi les cases a cocher 
Modifiers appropriees. 

Mode Manual : En mode Manual, vous fournissez toutes les informations qui 
definissent le raccourci. Vous devez determiner si la touche est une touche 
ASCII ou une touche virtuelle. S'il s'agit d'une touche virtuelle, vous devez 
connaitre l'identificateur Windows et le taper en lettres majuscules. Vous 
devez aussi selectionner le bouton radio Key Type approprie (ASCII ou 
Virtual Key), et activer la combinaison appropriee des cases a cocher Alt, Shift 
etCtrl. 

Fonction Flash La fonction Flash fait clignoter une commande barre menu lorsque 

l'utilisateur appuie sur le raccourci d'une commande associee a la 
commande de la barre menu. 

Par exemple, si vous avez selectionne un bloc de donnees dans plusieurs 
applications Windows et si vous appuyez sur Maj+Suppr (l'equivalent de la 
selection Edit I Cut), Windows inverse temporairement le clignotement de 
la commande Edit de la barre menu. Cette fonction permet a l'utilisateur de 
connaitre le menu associe au raccourci. 

La fonction Flash (egalement appelee element menu inverse) est activee par 
defaut lorsque vous creez un raccourci. Vous pouvez l'inhiber en 
desactivant l'option Invert Menu Item dans le volet Attribute de l'editeur 
Accelerator. 

Recherche des combinaisons de touches redondantes 

Pour verifier si vous n'utilisez pas la meme combinaison de touches 
plusieurs fois, vous pouvez deboguer une table de raccourcis en recherchant 
les combinaisons en double comme suit : 

1. Avec une table de raccourcis ouverte, choisissez Accelerator I Check 
Dup Keys. 
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2. Si deux raccourcis ont la meme combinaison de touches, l'editeur 
Accelerator affiche le message "Duplicate key value found" et met en 
surbrillance le second raccourci. Effectuez les modifications et continuez 
a deboguer votre table de raccourcis avec Check Dup Keys jusqu'a ce que 
le message "No duplicate key values found" s'affiche. 



Creation d'un exemple de table de raccourcis 



Dans cette section, vous allez creer une table de raccourcis pour le menu 
Widgets, decrit a la section "Exemple de menu" du chapitre 16. Sans 
Resource Workshop, utilisez un editeur de texte ou un traitement de texte 
pour creer le script ressource de la section precedente. 

■^ Si vous n'aviez pas enregistre le menu exemple dans le chapitre 16, vous 
pouvez quand meme travailler avec cette section. Dans le cas contraire, 
plusieurs etapes vous proposent des instructions supplementaires ou des 
alternatives. Pour creer une table de raccourcis avec l'editeur Accelerator de 
Resource Workshop, procedez comme suit : 

Le chapitre 14 decrit la 1. Ouvrez un fichier projet ou, si vous aviez enregistre le menu exemple 
procedure d'ouverture dans le chapitre 16, ouvrez le projet contenant votre menu Widgets. 

2. Choisissez Resource I New. 



d'un projet. 



3. Dans la boite de dialogue New Resource, double-cliquez le type de 
ressource ACCELERATOR. Vous apercevez l'editeur Accelerator avec 
une nouvelle entree. 

Si vous aviez enregistre le menu exemple du chapitre 16, ouvrez l'editeur 
Menu en double-cliquant sur son nom dans la fenetre projet. 
Redimensionnez les fenetres pour les editeurs Menu et Accelerator afin 
de les visualiser simultanement. 

Dans la fenetre Outline de l'editeur Menu, mettez en surbrillance 

l'element de menu List et notez son identificateur (wmnu_List) et son 

raccourci (Ctrl+L). 

Cliquez sur le nouveau raccourci dans l'editeur Accelerator. Si 

necessaire, appuyez sur F6 pour mettre en surbrillance la boite de saisie 

Command. 

4. Dans la boite de saisie Command, entrez le nom de l'identificateur pour 
la premiere commande du menu (wmnu_List). 
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5. Deplacez-vous par tabulations jusqu'a la boite de saisie Key. 

Notez que vous etes en mode Key Value. Appuyez sur Ctrl+L. L'editeur 
Accelerator entre la valeur ASCII " A L" et selectionne le bouton radio 
ASCII pour vous. 

6. Appuyez sur Alt+Echap pour sortir du mode Key Value, puis sur Entree 
pour valider ces parametres sur la touche raccourci en surbrillance dans 
le volet Outline. 

Si vous ne travaillez pas avec un projet existant, Resource Workshop 
vous invite a creer un identificateur pour ce raccourci. Cliquez sur Yes, 
puis sur OK dans la boite de dialogue New Identifier pour accepter la 
valeur par defaut. 

7. Appuyez sur Inser pour creer un nouveau raccourci. 

Si vous travaillez avec le menu Widgets du chapitre 5, cliquez sur 
l'editeur Menu. Selectionnez la commande suivante avec une touche 
raccourci, et notez son identificateur d'element et sa touche de raccourci. 

8. Ajoutez les raccourcis restants : wmnu_Add, wmnu_Asc et wmnu_Desc en 
substituant la combinaison de touches et l'identificateur appropries, 
jusqu'a ce que tous les raccourcis soient definis. 

9. Enregistrez le projet. 

La table de raccourcis est maintenant terminee. Dans les etapes suivantes, 
vous allez volontairement creer un doublon (valeur de touche) afin de 
deboguer votre table de raccourcis au moyen de l'editeur Accelerator. 

1. Mettez en surbrillance le second raccourci et changez sa valeur de touche 
de Ctrl+A a Ctrl+L. 

Appuyez sur Ctrl+\ pour mettre en surbrillance le raccourci, Tab pour 
activer le mode Key Value. 

2. Tapez Ctrl+L, appuyez sur Alt+Esc et sur Entree pour valider la 
modification. 

3. Choisissez Accelerator I Check Dup Keys. Resource Workshop affiche la 
boite de dialogue "Duplicate key value found". Appuyez sur Entree pour 
la fermer. 

4. Mettez maintenant en surbrillance wmnu_Asc ou wmnuJDesc dans le 
volet Outline et appuyez sur Suppr. 

5. Affichez le menu Edit. Notez que le choix Undo Delete Item se refere a 
votre suppression du dernier raccourci. 
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6. Choisissez Undo Delete Item pour restaurer le raccourci supprime. 

7. Affichez a nouveau le menu Edit. La commande Undo indique 
maintenant Undo Change Item. Lorsque vous choisissez cette 
commande, le raccourci de la commande Add change de Ctrl+L a Ctrl+A. 

8. Choisissez a nouveau Accelerator I Check Dup Keys. Vous devriez 
obtenir le message "No duplicate key values found". 

Cet exemple vous montre combien il est facile de creer des raccourcis en 
utilisant a la fois l'editeur Menu et l'editeur Accelerator. Vous pouvez 
passer alternativement d'un editeur a un autre pour connaitre les 
associations entre raccourcis et commandes menus. Vous pouvez aussi 
utiliser le mode Key Value pour entrer les touches, tout en laissant l'editeur 
Accelerator travailler a votre place. Ensuite, vous pouvez verifier si vous 
n'avez pas cree de touches en double. Dans l'affirmative, vous pourrez tres 
facilement les modifier a la fois dans le menu et dans la table des raccourcis. 
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Creation d'une table de chaines 



Une table de chaines contient les messages d'erreur, les messages d'invite ou 
toute autre chaine de texte que votre application devra afficher. Vous 
pouvez memoriser plusieurs tables de chaines dans votre fichier projet. En 
principe, vous allez definir une table de chaines specifique pour chaque 
regroupement logique de votre programme (voir la section "Comment 
travailler avec des tables de chaines" plus loin dans ce chapitre). 

Si vous definissez les chaines de texte comme ressources separees, il vous 
sera plus facile d'editer du texte sans modifier votre code source. Par 
exemple, si vous traduisez une application Windows dans une langue 
etrangere, les tables de chaines vous simplifieront le travail. Neanmoins, 
vous devrez traduire le texte d'autres ressources, comme les boites de 
dialogue. 

Travailler avec des tables de chaines implique quatre taches essentielles : 

1. Lancer l'editeur String. 

2. Creer et editer des tables de chaines. 

3. Enregistrer la table de chaines. 

4. Compiler la ressource dans un fichier executable et tester la table de 
chaines. 

A la section "Creation d'un exemple de table de chaines" de ce chapitre, 
vous trouverez un petit exemple concernant la creation et l'edition d'une 
table de chaines. 
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Lancement de I'editeur String 



La procedure de lancement de I'editeur String depend de la tache realisee : 
creation d'une nouvelle table de chaines ou edition d'une table existante. 



Creation d'une 
nouvelle table de 
chaines 



Suivez la procedure ci-dessous pour lancer I'editeur String afin de creer une 
nouvelle table de chaines : 

1. Ouvrez le projet auquel vous souhaitez ajouter la table. 

2. Choisissez Resource I New. Resource Workshop affiche la boite de 
dialogue New Resource. 

3. Faites defiler le contenu de la boite liste Resource Type et double-cliquez 
sur STRINGTABLE. 

Resource Workshop ouvre I'editeur String et place une reference a la 
nouvelle table de chaines dans votre fenetre projet. 



Edition d'une table 
de chaines 
existante 



Suivez la procedure ci-dessous pour lancer I'editeur String afin d'editer une 
table de chaines existante : 

1. Ouvrez le projet contenant la table de chaines a editer. 

2. Trouvez la table de chaines dans la fenetre projet. 

3. Double-cliquez sur l'entree de la table de chaines, ou selectionnez-la et 
choisissez Resource I Edit. 

La table de chaines selectionnee apparait dans I'editeur String. 
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Comment travailler avec des tables de chaines 



Si vous ouvrez l'editeur String, une table de chaines apparait. Si vous creez 
une nouvelle table de chaines, vous voyez une entree unique avec le texte 
generique "String". Si vous editez une table de chaines existante, vous voyez 
les entrees de chaines, comme ci-dessous : 



Figure 18.1 
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Help on Paste 
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Chaque entree requiert une valeur dans les colonnes suivantes : ID Source, 
ID Value et String. 

■ ID Source contient le nombre entier de la chaine. Si vous affectez un nom 
d'identificateur, il apparait dans cette colonne. Sinon, vous apercevez un 
nombre entier. 

■ ID Value contient toujours l'identificateur entier de la chaine. 

■ Une chaine, d'une longueur maximale de 255 caracteres, est stockee dans 
la colonne String. 

Vous pouvez cliquez sur un element avec le bouton droit de la souris pour 
afficher un TurboMenu qui vous permet d'executer rapidement les taches 
qui s'y rapportent (vous pouvez aussi selectionner l'element et appuyer sur 
Alt+F10). La section suivante decrit comment Windows gere les valeurs 
d'identificateur de chaines, et vous suggere une methode permettant une 
meilleure utilisation de la memoire. 
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Windows et les 
chaines 



Pour plus de details, 

reportez-vous a voir la 

section "Comment 

utiliser les 

identificateurs" du 

chapitre 14. 



Chaque chaine d'une table doit disposer d'un identificateur entier unique. 
Windows regroupe les chaines en segments de 16 chaines chacun. Les 
chaines avec les identificateurs de a 15 constituent le premier segment, les 
chaines 16 a 31 le deuxieme, etc. Lorsque vous compilez vos ressources, les 
chaines s'ajoutent au fichier executable en segments, charges en memoire au 
moment de 1' execution. 

Si votre application requiert une chaine specifique, Windows charge un 
segment de chaines entier en memoire. Si vous savez comment affecter les 
identificateurs de chaines, vous pouvez reduire la quantite de memoire 
requise par votre application. 

Supposons que vous definissiez 32 chaines pour votre application. Si vous 
affectez les identificateurs a 31 a ces chaines, votre fichier executable 
contient deux segments de 16 chaines. Chaque fois que votre application 
requiert une chaine et charge un segment, elle charge probablement 
plusieurs chaines inutiles. 

Pour une meilleure utilisation de la memoire, regroupez vos chaines 
logiquement. Par exemple, une partie de votre application a besoin de cinq 
chaines, et une seconde partie requiert neuf chaines. Si vous numerotez le 
premier groupe a 4, et le second groupe 16 a 24, vous creez deux segments, 
le premier avec onze identificateurs inutilises et le second avec sept 
identificateurs inutilises. Chaque identificateur inutilise occupe uniquement 
un octet en memoire, compare a l'espace tres important occupe par les 
chaines dont vous n'avez pas besoin. En organisant vos chaines de cette 
facon, Windows charge les chaines associees sans charger les chaines 
inutiles. 

Si vous indiquez un identificateur de chaine unique, vous pouvez utiliser un 
nombre entier ou un identificateur alphanumerique (#define dans C ou 
C++, ou declaration constante en Pascal) qui represente un nombre entier. Si 
vous utilisez des identificateurs alphanumeriques pour vous rappeler plus 
facilement des identificateurs de chaines, memorisez-les dans un fichier 
identificateur (fichier en-tete pour C et C++; fichier unite ou fichier inclus 
pour Pascal). Verifiez si ces fichiers existent avant d'ajouter des 
identificateurs a partir de l'editeur String. 
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Entree d'une 
nouvelle chaine 



Pourrevenirau 

parametre initial de ID 

Source, appuyez sur 

Echap avant Tab ou 

Entree. 



Pourrevenirau 

parametre initial du 

champ String, appuyez 

sur Echap avant Tab 

ou Entree. 



Pour entrer une nouvelle chaine dans une table : 

■ Si votre table est nouvelle, entrez simplement les informations de la 
chaine, comme decrit aux etapes 3, 4 et 5 ci-apres. 

■ Si vous ajoutez une chaine dans une table, commencez a l'etape 1 ci-apres. 

1. Selectionnez la chaine au-dessus de la ligne ou vous souhaitez ajouter la 
nouvelle chaine. 

2. Appuyez sur Inser ouchoisissez Stringtable I New Item. 

3. Vous pouvez accepter le numero que l'editeur String place dans ce 
champ, ou vous pouvez taper un identificateur entier ou 
alphanumerique pour ID Source. 

Si vous tapez une valeur entiere, l'editeur String entre automatiquement 
cette valeur dans le champ ID Value. 

Si vous tapez une valeur alphanumerique, Resource Workshop verifie si 
cette valeur existe deja. Dans ce cas, l'editeur String insere la valeur 
entiere d'identificateur dans le champ ID Value lors du deplacement du 
pointeur a l'aide de la touche Tab vers le champ texte String. Si la valeur 
alphanumerique n' existe pas, l'editeur String affiche la boite de dialogue 
"Create a new identifier". 

Pour plus de details, reportez-vous au paragraphe "Comment utuiliser 
les identificateurs" du chapitre 14. 

4. Appuyez sur Tab ou cliquez dans la boite au-dessous de String, et tapez 
la chaine de texte. 

Chaque chaine contient 255 caracteres maximum et peut aussi contenir 
toute sequence d'echappement de type C, y compris : \n (nouvelle 
ligne), \t (tab), \r (retour chariot), \\ (barre oblique inverse), \" 
(guillemets). 

Si le compilateur Resource Workshop rencontre une sequence 
d'echappement de type C dans une entree de chaine, il genere la valeur 
hexadecimale ASCII correspondante dans le code objet. C'est votre 
programme qui interpretera la valeur correctement. Par exemple, si le 
compilateur analyse \b\040\x7F, il genere la sequence hexadecimale 
07207F. Votre code peut interpreter cette sequence comme les caracteres 
ASCII BEL, SPC et DEL, ou encore affecter une autre signification a ces 
valeurs hexadecimales. 

5. Appuyez sur Entree (pour accepter la nouvelle valeur) ou Inser (pour 
accepter la valeur et en inserer une nouvelle). 
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Edition de chaines L'editeur String vous permet de modifier facilement des chaines. Pour 
existantes selectionner une chaine avec la souris, cliquez sur la chaine a editer. Avec le 

clavier, appuyez sur Tab, T ou 4- pour vous deplacer dans la table. Placez le 

curseur sur la chaine a editer. 



Modification d'une 
chaine 



Vous pouvez effacer les valeurs des champs ID Source et String d'une 
chaine et taper de nouvelles valeurs. Vous ne pouvez pas modifier 
directement les valeurs qui s'affichent dans le champ ID Value. L'editeur 
String actualise la valeur suivant les informations saisies dans le champ ID 
Source. 



Edition du script 
ressource d'une 
table de chaines 



Vous pouvez utiliser l'editeur de texte interne pour editer le script ressource 
d'une table de chaines. Pour cela, selectionnez la table de chaines dans la 
fenetre projet et choisissez Resource I Edit As Text. 

Le texte du script ressource apparait, pret pour l'edition. 



Modification de 
chaines 



Pour editer une chaine, procedez comme suit : 

1. Recherchez la chaine a editer et apportez les modifications requises. 
Modifiez uniquement le texte qui s'affiche entre guillemets. 

2. Pour compiler votre saisie et rester dans l'editeur String, choisissez 
Compile I Compile Now. 

Notez que le menu Compile est uniquement disponible dans l'editeur de 
texte. 

3. Si vous voulez quitter l'editeur String, choisissez la commande Close 
dans la boite Control-menu de la fenetre de l'editeur de texte. 

Resource Workshop vous invite a compiler. Lorsque vous cliquez sur 
Yes, il compile le menu et quitte la fenetre projet. 

En cas d'erreur syntaxique, Resource Workshop revient dans l'editeur de 
texte pour que vous puissiez corriger l'erreur. 
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Creation d'un exemple de table de chaines 



Ces chaines devraient 

apparaitre sur la ligne 

d'etat Resource 

Workshop. 



Pour plus de details, 

reportez-vous a la 

section "Comment 

utiliser les 

identificateurs" du 

chapitre 14. 



L' exemple qui suit cree quelques chaines que Resource Workshop utilise 
pour decrire les options de menus. 

Sans Resource Workshop, vous utiliseriez le script ressource ci-apres pour 
creer ces chaines : 



STRINGTABLE 

BEGIN 

MENU_FILE, 
MI_FILENEW, 
MI_FILEOPEN, 
MI_FILESAVE, 

END 



"Create, open, or close files" 

"Create a new project, resource, or file" 

"Open a resource file" 

"Save this resource file" 



La chaine alphanumerique en majuscules qui precede chaque chaine est un 
identificateur unique pour la chaine. Comme toutes les ressources 
Windows, chaque chaine doit etre designee par un nombre entier. Sans 
Resource Workshop, vous devriez definir separement les valeurs entieres de 
tous ces identificateurs dans un fichier en-tete (programme C) ou dans un 
fichier inclus ou une unite (programme Pascal). 

Nous allons vous expliquer comment creer ces chaines exemple avec 
l'editeur String de Resource Workshop : 

1. Verifiez si vous avez deja ouvert un projet. Si vous avez deja travaille sur 
des exemples en utilisant MYPROJ.RC, vous pouvez ouvrir ce projet. 

2. Si vous ne possedez pas deja un fichier identificateur (fichier en-tete pour 
les #define du C, unite ou fichier inclus pour les constantes Pascal) pour 
le projet, creez-le maintenant et appelez-le MYPROJ.H ou MYPROJ.PAS. 

3. Choisissez Resource I New et double-cliquez STRINGTABLE pour 
lancer l'editeur String. 

4. Faites des retours arriere sur le numero de la boite de saisie au-dessous 
de ID Source et tapez l'identificateur de la chaine. Pour la premiere 
chaine, c'est MENU_FILE. 

5. Appuyez sur Tab pour aller jusqu'a String. 

Avant que l'editeur String vous laisse passer au champ String, il 
recherche une valeur entiere d'identificateur pour la chaine courante. 
Tout d'abord, il verifie ce que vous avez tape au-dessous de ID Source. Si 
vous avez entre un nombre entier, l'editeur String place ce meme 
nombre au-dessous de ID Value et vous laisse passer au champ String. 
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Pour plus de details, 

reportez-vous a la 

section "Comment 

utiliser les 

identificateurs" du 

chapitre 14. 



Puisque vous avez entre un identificateur alphanumerique (MENU_FILE 
dans ce cas), l'editeur String recherche une declaration de constante C 
#define ou Pascal qui designe le nombre entier. Cette declaration n'existant 
pas, il vous demande si vous souhaitez creer un nouvel identificateur. 

6. Cliquez sur Yes pour appeler la boite de dialogue New Identifier. 

7. Faites defiler la liste File jusqu'a MYPROJ.H (ou MYPROJ.PAS), puis 
double-cliquez sur ce fichier pour le selectionner comme le fichier 
identificateur dans lequel le nouvel identificateur sera ecrit. 

8. Entrez une valeur entiere d'identificateur dans la boite de saisie Value. 
Tapez 7 68 pour le premier identificateur. 

9. Appuyez sur Entree ou cliquez sur OK pour accepter le nouvel 
identificateur et le placer dans MYPROJ.H ou MYPROJ.PAS. 

10. Puisque vous en avez termine avec l'identificateur, vous revenez au 
champ String. Tapez le texte de la chaine, c'est-a-dire Create, open, 
or close files pour la premiere chaine. 

11. Pour definir la chaine suivante, appuyez sur Inserou choisissez 
Stringtable I New Stringtable Item. 

Repetez les etapes 4 a 11 pour definir les trois autres chaines representees au 
debut de la section : MI_FILENEW, MI_FILEOPEN et MI_FILESAVE (voir la 
figure 18.2). 

Vous avez remarque que pour chaque nouvelle chaine, l'editeur String 
incremente de 1 la derniere valeur entiere d'identificateur. Vous n'avez pas 
besoin de selectionner ce nombre. L'editeur String le met simplement ici a 
votre disposition. 

Une fois les quatre chaines creees, votre table de chaines s'affiche comme 
suit : 



Figure 18.2 

Editeur String avec 

quatre cnaines 

definies 



= 




STRINGTABLE: MENU FILE 


H- 


ID Source 


I ID Value I String 


!♦ 


MENLJ^FILE 

^rFLENEw]^ 
Ml'FiLEOPEN 


I 7G3 I Create, open, or close files 

! 769 ! Create a new project resource or file 

! 770 I Open a resource file 




Ml FILE SAVE 


I 771 1 Save this resource file 


IT 


>l I 




hi 
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En derniere etape, fermez la table de chaines en choisissant Close dans le 
menu Control de la fenetre de l'editeur String. L'editeur String donne a la 
nouvelle table le nom du premier identificateur de la table. Si la premiere 
entree ID Source est un numero, il devient le nom de la table de chaines. 
Pour modifier le nom d'une table de chaines, vous devez done modifier la 
premiere entree ID Source de la table. 

Cette convention sur les noms est logique. En effet, les chaines sont chargees 
par segments de 16 chaines chacun. En outre, la valeur entiere de 
l'identificateur d'une chaine indique l'endroit ou la chaine apparait dans un 
segment. Celle de la premiere chaine de la table indique l'endroit ou la table 
commence dans un segment. 
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19 



Les fonctions 

specifiques aux 

differents types de 

ressources sont 

decrites dans les 

chapitres 20 a 22. 



Comment utiliser l'editeur Bitmap 



L'editeur Bitmap de Resource Workshop est l'outil utilise pour creer ou 
editer une ressource bitmap, y compris les ressources bitmap standard : 

■ Icones 

■ Curseurs 

■ Graphiques par points 

■ Polices 

Ce chapitre decrit les fonctions et les outils de l'editeur Bitmap identiques a 
tous les types de ressources bitmap. Les chapitres relatifs aux ressources 
specifiques decrivent les fonctions et les outils de l'editeur Bitmap propres a 
chaque type de ressource. 



Lancement de l'editeur Bitmap 



Resource Workshop lance automatiquement l'editeur Bitmap lorsque vous 
creez une nouvelle ressource bitmap, ou editez une ressource bitmap 
existante. Les etapes specifiques au lancement de l'editeur Bitmap sont 
fournies dans les chapitres relatifs aux ressources individuelles. 

Si vous creez une ressource bitmap alors que le Presse-papiers de Windows 
en contient deja une, les dimensions de celle-ci apparaissent dans la boite de 
dialogue New Bitmap attributes ; si le Presse-papiers ne contient pas de 
ressource bitmap, les dimensions par defaut (largeur et hauteur) sont de 64 
pixels. 
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Couleurs de premier plan et de fond, et pixels 



Voir la section 

"Utilisation des 

couleurs de premier 

plan et de fond" de ce 

chapitre pour plus 

d'informations sur les 

couleurs de premier 

plan et de fond. 



Les images bitmap dessinees avec l'editeur Bitmap sont creees sur une grille 
de "points" approximativement carres, appeles pixels. Vous creez l'image en 
parametrant chaque pixel comme une couleur de premier plan ou de fond. 
Les pixels s'assemblent comme une mosai'que pour former l'image bitmap. 

Puisque les pixels cohabitent sur un plan unique, il n'y a aucune distinction 
entre le premier plan et le fond. En termes simples, la couleur de premier 
plan est la couleur que vous selectionnez et dessinez avec le bouton gauche 
de la souris; et la couleur de fond est la couleur que vous selectionnez et 
dessinez avec le bouton droit de la souris. 

Vous pouvez utiliser une variete de couleurs de premier plan et de fond 
pour les caracteristiques de votre dessin (lignes, boites, ombre, etc.), aussi 
bien pour le "fond" de l'image (qui est, apres tout, une illusion, etant donnee 
la nature bi-dimensionnel de l'image). La possibilite d'affecter des couleurs 
aux deux boutons de la souris signifie que vous avez deux couleurs a votre 
disposition a tout moment. 

II existe une difference importante entre la couleur de premier plan et de 
fond. Lorsque vous effacez ou deplacez un bloc de pixels dans votre image 
(voir la section "Outil rectangle de selection" plus loin dans ce chapitre), la 
couleur de fond actuellement selectionnee remplace la couleur dans les 
pixels qui ne sont plus occupes par le bloc. 

Si vous utilisez l'outil Gomme, les boutons sont inverses : le bouton gauche 
genere la couleur de fond, et le bouton droit genere la couleur de premier 
plan. 

La couleur de premier plan courante est indiquee par FG sur la palette 
Colors, et la couleur de fond courante par BG. Si vous selectionnez la meme 
couleur pour le premier plan et le fond, le carre de la palette Colors 
contient FB. 



Utilisation de la palette Tools (Outils) 



Lorsque vous ouvrez une ressource dans l'editeur Bitmap, la palette Tools 
est situee dans Tangle superieur droit de la fenetre d'edition. Utilisez la 
palette Tools pour choisir l'outil de l'editeur Bitmap avec lequel travailler. 
Au bas de la palette Tools figurent quatre selections de style concernant les 
formes de pinceaux, les motifs de remplissage et les largeurs de ligne. 
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Figure 19.1 
Palette Tools de 

I'editeur Bitmap 



Si la palette Colors 

indique FB, la meme 

couleur est 

selectionnee pour le 

premier plan et le fond 



rectangle 
de selection 

Zoom 



Stylo 



Aerographe 



Ligne 



Cadres vides < 



Forme 
pinceau 

Type de stylo 



a 




Us 


X 


0^> 


Hi 


ft 


%> 


\ 


T 





2 





• 


t 


■ 



Ciseaux 

Gomme 
Pinceau 

Boite de peinture 

Texte 



> Cadres pleins 



Forme 
aerographe 

Motif 



La palette Tools est similaire a une lenetre : vous pouvez la deplacer, la 
fermer et l'ouvrir. 

La plupart des outils vous permettent de dessiner soit avec la couleur de 
premier plan, soit avec la couleur de fond. 

■ Utilisez le bouton gauche de la souris pour dessiner avec la couleur de 
premier plan (marquee FG dans la palette Colors). 

■ Utilisez le bouton droit pour la couleur de fond (signalee par BG dans la 
palette Colors). 
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Outil Rectangle de 
selection 



*-fc 



Choisissez Edit | Select 

All pour selectionner 

toute I'image 



L'outil Rectangle de selection selectionne une zone rectangulaire de votre 
image, en vue de sa copie, son deplacement ou son effacement. Pour 
selectionner une zone, placez le bout du pointeur sur un angle du rectangle, 
et faites glisser le pointeur sur Tangle diagonalement oppose. Lorsque le 
contour clignotant entoure la zone voulue, relachez le bouton de la souris. 
Pour deselectionner la zone, cliquez hors du contour clignotant, ou bien 
appuyez sur Entree ou Echap. 

Lorsque vous selectionnez une zone, vous pouvez utiliser les commandes 
du menu Edit pour couper, copier, effacer, dupliquer, ou coller la zone 
selectionnee, ou encore utiliser la souris pour deplacer ou dupliquer la zone. 



Outil Ciseaux 



Fondamentalement, l'outil Ciseaux realise la meme fonction que l'outil 
Rectangle de selection : la selection d'une zone d'image. Cependant, avec les 
ciseaux, vous pouvez selectionner et deplacer des zones de toute forme, et 
non plus simplement des rectangles. 

Pour selectionner une zone, faites glisser les ciseaux jusqu'a ce que le 
contour entoure la zone voulue, puis relachez le bouton de la souris. La 
zone selectionnee est indiquee par l'affichage d'un motif en clignotement. 
Vous pouvez couper, copier, effacer, dupliquer ou deplacer la zone 
selectionnee, comme avec l'outil Rectangle de selection (procedure decrite 
dans la section precedente). 



Outil Zoom 







L'editeur Bitmap utilise 

le centre de I'image 

comme point de 

reference lors d'un zoop 

sur toute I'image. 



Vous pouvez utiliser l'outil Zoom pour zoomer en avant ou en arriere sur 
I'image entiere, ou encore pour zoomer sur une zone selectionnee. 

Pour zoomer en avant sur toute I'image, double-cliquez sur l'icone Zoom de 
la palette Tools. Resource Workshop effectue un Zoom jusqu'au 
grossissement superieur : 400%, 800% ou 1600%. Vous pouvez aussi choisir 
View I Zoom In pour executer la meme fonction sur la fenetre actuellement 
selectionnee. 

Lorsque vous effectuez un zoom en avant sur I'image, utilisez l'outil Main 
(voir la section "Outil Main" plus loin dans ce chapitre) ou les barres de 
defilement pour vous deplacer dans I'image zoomee. 

Pour zoomer en arriere sur toute I'image, maintenez enfoncee la touche Maj, 
puis double-cliquez sur l'icone Zoom. Pour zoomer sur une partie de 
I'image, selectionnez la zone voulue en faisant glisser le rectangle de l'outil 
Zoom, puis relachez le bouton de la souris. Resource Workshop effectue un 
zoom arriere jusqu'au grossissement inferieur : 800%, 400% ou 100%. Vous 
pouvez aussi choisir View I Zoom Out pour executer la meme fonction. 
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Tableau 19.1 

Commandes de 

zoom 



Outil Gomme 



^ 



Si la mention FB 

apparait dans la palette 

Colors, la meme 

couleur est 

selectionnee comme 

couleur de fond et de 

premier plan en cours. 



Commande de 
zoom 

Zoom avant 
Zoom arriere 
Taille normale 



Raccourci 

Ctrl+Z 
Ctrl+O 
Ctrl+A 



Operation de lasouris 
sur I'icone Zoom 

Double-clic 
Maj.+double-clic 



Pour pouvoir controler l'image point par point, vous pouvez afficher une 
grille de pixels portant sur l'image zoomee en cours. Pour cela, choisissez 
Options I Editor Options et cochez la case Grid on Zoomed Window. 
Chaque carre de la grille correspond a un pixel. 

Lorsque vous travaillez avec deux volets de fenetre (voir la section 
"Utilisation des deux volets de la fenetre" plus loin dans ce chapitre), Taction 
de zoomer affecte uniquement la fenetre courante (active). 

Vous pouvez utiliser l'outil Gomme pour effacer toute l'image, ou bien 
comme outil de dessin. Les affectations de couleurs aux boutons de souris 
pour l'outil Gomme sont inversees par rapport a celles des autres outils de 
dessin. 

■ Si vous double-cliquez sur la gomme dans la palette Tools, toute l'image 
est remplacee par la couleur de fond en cours (BG sur la palette Colors). 

■ Si vous faites glisser le pointeur a l'aide du bouton gauche de la souris, la 
gomme dessine une ligne de 1 pixel de large avec la couleur de fond en 
cours. 

■ Si vous faites glisser le pointeur a l'aide du bouton droit de la souris, la 
gomme dessine une ligne de 1 pixel de large avec la couleur de premier 
plan en cours (FG sur la palette Colors). 

Avant d'utiliser la gomme, vous pouvez verifier les couleurs en cours dans 
la palette Colors. 



Outil Stylo 



L'outil Stylo dessine des lignes au format libre au moyen du type de stylo en 
cours affiche dans la palette Tools (voir la figure 19.1). Pour dessiner avec 
l'outil Stylo, appuyez sur un bouton de la souris, et faites glisser le stylo 
dans votre image. Lorsque vous avez fini de dessiner, relachez le bouton de 
la souris. Pour dessiner des lignes droites, utilisez l'outil Ligne a la place de 
l'outil Stylo. 
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Outil Pinceau 



3 



Outil Aerographe 



31 



L'outil Pinceau dessine des motifs libres en utilisant le style de pinceau et le 
motif en cours affiches dans la palette Colors (voir la figure 19.1). Pour 
dessiner, faites glisser le pinceau dans votre image. Lorsque vous avez 
termine, relachez le bouton de la souris. 

Lorsque vous selectionnez le pinceau, le curseur prend la forme de pinceau 
en cours. La zone dessinee par le pinceau est toujours proportionnelle a la 
taille du cadre de l'image. En d'autres termes, si le pinceau represente la 
moitie de la largeur de l'image et que vous zoomez sur cette image, le 
pinceau representera toujours la moitie de l'image zoomee. 

Avant d'utiliser le pinceau, vous pouvez specifier la forme, le motif et les 
couleurs. 

L'outil Aerographe dessine des motifs libres en utilisant le style de 
l'aerographe et le motif en cours affiches dans la palette Colors (voir la 
figure 19.1). Pour utiliser l'aerographe, executez une des deux procedures 
suivantes : 

■ Vous pouvez le faire glisser a travers l'image. L'aerographe est different 
du pinceau. En effet, si vous le faites glisser doucement, il dessine un 
motif epais. Par contre, si vous le faites glisser rapidement, il dessine un 
motif plus fin et disperse. 

■ Vous pouvez le cliquer de facon repetitive, comme si vous appuyiez sur le 
diffuseur d'une bombe de peinture. 

Lorsque vous selectionnez l'aerographe, le curseur prend la forme de 
pinceau en cours. La zone dessinee par l'aerographe est toujours 
proportionnelle a la taille du cadre de l'image. En d'autres termes, si 
l'aerographe represente la moitie de la largeur de l'image et que vous 
zoomez sur cette image, l'aerographe representera toujours la moitie de 
l'image zoomee. 

Avant d'utiliser l'aerographe, vous pouvez specifier la forme, le motif et les 
couleurs. 



Outil Boite de 
peinture 



L'outil Boite de peinture remplit une zone de votre image avec la couleur 
selectionnee. Pour utiliser la boite de peinture, placez le viseur dans la partie 
de l'image que vous voulez remplir, puis cliquez sur un bouton de la souris. 
La boite de peinture remplace la couleur situee sous le curseur par la 
couleur selectionnee, et remplit autour de ce point jusqu'a ce qu'elle 
rencontre une couleur differente. 
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Par exemple, si la couleur selectionnee est rouge et que vous cliquez sur un 
carre bleu, tout le bleu autour de ce point sera remplace par du rouge. La 
boite de peinture ne remplacera pas les autres couleurs. Si le carre bleu fait 
partie d'une zone rectangulaire bleue entierement delimitee par du vert, 
seul le rectangle bleu passera en rouge. 

Si vous cliquez sur une zone qui n'est pas entierement delimitee par 
d'autres couleurs, la couleur s'etendra sur toutes les autres parties de 
l'image de meme couleur que la zone d'origine. 

A cause des problemes inherents aux pilotes video, le remplissage total 
d'une image bitmap avec la boite de peinture ne fonctionne pas toujours 
correctement. Pour resoudre ce probleme, Resource Workshop offre une 
alternative a l'algorithme de remplissage standard, plus efficace mais plus 
lente. Pour valider cet algorithme pour l'un des editeurs de ressources 
bitmap, ajoutez la ligne suivante dans la section [RWS_Icon] de 
WORKSHOP.INI : 

RWS_OwnFloodFill=l 

L'exemple suivant illustre la section RWS_Icon modifiee : 

[RWS_Icon] 
RWS_OwnFloodFill=l 
Percent Left =69 
ZoomLeft=8 
ZoomRight=l 
bVert=l 



Outil Ligne 



Pour les lignes libres, 
utilisez le stylo. 



\ 



L'outil Ligne dessine les lignes droites. Appuyez sur le bouton de la souris, 
et faites glisser l'outil Ligne dans votre image. Lorsque le dessin de la ligne 
est termine, relachez le bouton de la souris. 

Pour contraindre les lignes a des increments de 45 degres (horizontalement, 
verticalement ou en diagonale), maintenez enfoncee la touche Maj lorsque 
vous dessinez. 

Avant d'utiliser l'outil Ligne, vous pouvez specifier le style et les couleurs 
en cours. 
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Outil Texte 



Tl 



Pour ajouter du texte a votre image, choisissez l'outil Texte, et cliquez sur 
l'endroit ou votre texte doit debuter. Un curseur clignotant vous invite a 
saisir le texte. 

Pour specifier comment et ou le texte est affiche, vous pouvez : 

■ Utiliser Text I Font pour specifier la police, la taille et le style du texte. 

■ Utiliser les commandes Text I Align pour specifier l'alignement du texte. 

Pour plus d'informations sur les commandes du menu Text, reportez-vous a 
la section "Ajout de texte a une ressource" plus loin dans ce chapitre. 

II est inutile de choisir des commandes du menu Text avant d'entrer le 
texte ; vous pouvez aussi les choisir immediatement apres la saisie (avant de 
cliquer a nouveau). Par exemple, si vous notez pendant la saisie que le texte 
est trop grand pour s'adapter a l'image, vous pouvez arreter la saisie et 
choisir la commande Font pour diminuer la taille du texte. 

Le texte est toujours affiche dans la couleur de premier plan en cours. Avant 
de saisir le texte, vous pouvez specifier la couleur de premier plan, en 
cliquant le bouton gauche de la souris sur la couleur souhaitee dans la 
palette Colors. Comme pour la police et la taille, vous pouvez modifier la 
couleur de texte en cours, sous reserve de le faire immediatement apres la 
saisie. 



Dessin de cadres 
vides 



o 
o 



Trois outils vous permettent de dessiner des cadres vides en utilisant le style 
et la couleur de ligne en cours : le rectangle, le rectangle arrondi et l'ellipse. 

Pour dessiner un cadre vide, selectionnez l'outil voulu et amenez un cadre 
dans l'image. Placez le viseur du curseur sur un angle du cadre et faites-le 
glisser sur l'angle oppose. Relachez le bouton de la souris lorsque le cadre 
vous convient. Appuyez sur Maj pour dessiner un carre ou un cercle. 

Avant de dessiner un cadre, vous pouvez specifier l'epaisseur de trait et la 
couleur. 
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Dessin de cadres 
pleins 



Trois outils vous permettent de dessiner des cadres pleins dans votre 
image : le rectangle plein, le rectangle arrondi plein et l'ellipse pleine. 

Pour dessiner un cadre plein, selectionnez l'outil voulu et amenez un cadre 
dans l'image. Placez le viseur du curseur sur un angle du cadre et faites-le 
glisser sur Tangle oppose. Relachez le bouton de la souris lorsque le cadre 
vous convient. 

Ces outils utilisent le style de ligne en cours pour le contour. Specifiez une 
largeur de stylo nulle si vous ne souhaitez pas que Resource Workshop 
dessine un contour autour du motif plein. 

Le motif en cours est affiche dans Tangle inferieur droit de la palette Tools. 
Si vous faites glisser le pointeur a Taide du bouton gauche de la souris, le 
contour et le motif prennent la couleur de premier plan en cours (FG), et le 
remplissage du motif prend la couleur de fond en cours (BG). Si vous faites 
glisser le pointeur a Taide du bouton droit de la souris, les couleurs sont 
inversees. 

La boite de dialogue Set Pattern comprend aussi deux motifs pleins, un noir 
et un blanc. 

■ Si vous selectionnez le motif noir, le bouton gauche de la souris genere un 
remplissage total avec la couleur de premier plan, et un pourtour avec la 
couleur de fond. Comme d'habitude, le bouton droit de la souris genere 
un effet inverse. 

■ Si vous selectionnez le motif blanc, le bouton gauche de la souris genere 
un remplissage total avec la couleur de fond, et un pourtour avec la 
couleur de premier plan. A nouveau, le bouton droit de la souris genere 
un effet inverse. 

Avant de dessiner un cadre plein, vous pouvez specifier le style de ligne, 
la couleur et le motif. 



Outil Main 

Vous pouvez aussi utiliser 

les barres de defilement 

pour deplacer l'image. 



® 



Parfois, lorsque vous affichez une image zoomee, elle ne s'adapte pas 
entierement a Tecran. Vous pouvez utiliser l'outil Main pour deplacer 
l'image et en voir d'autres parties. A la difference des autres outils, l'outil 
Main n'est pas compris dans la palette Tools. Mais vous pouvez 
temporairement changer un outil (excepte l'outil Texte) en main, en 
maintenant enfoncee la touche Ctrl. A Taide de la main, vous pouvez attraper 
l'image et la faire glisser dans la direction voulue. 
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Selections de style Au bas de la palette Tools figure une boite qui affiche (dans le sens des 

aiguilles d'une montre, en partant de Tangle superieur gauche) la forme du 
pinceau, la forme de l'aerographe, le motif en cours et le style de ligne. 



a 



Vous pouvez cliquer chaque style que vous voulez changer, ou encore 
utiliser les commandes de menu pour choisir les styles. Pour plus 
d'informations sur le choix des styles, voir les sections "Choix des formes de 
pinceau", "Choix des motifs de dessin", et "Choix d'un style de ligne" plus 
loin dans ce chapitre. 



Utilisation des deux volets de la fenetre 



Dans l'editeur Bitmap, vous pouvez obtenir deux vues differentes de 
l'image creee ou editee. Vous pouvez diviser la fenetre verticalement ou 
horizontalement pour afficher deux vues cote a cote, ou bien une vue 
au-dessus de l'autre. Vous pouvez aussi choisir la facon de zoomer sur 
chaque vue. 

Pour diviser la fenetre, choisissez View I Split Horizontal ou View I Split 
Vertical. 

Lorsque la fenetre est divisee, un des volets est actif. Le volet actif est celui 
dans lequel vous travaillez. Pour activer un volet, cliquez avec la souris dans 
ce volet. 

Pour privilegier la vue d'une image par rapport a l'autre, deplacez le 
curseur sur la ligne divisant les images (la barre separatrice). Lorsque le 
curseur devient une double fleche, faites glisser cette barre separatrice. Par 
exemple, les fenetres etant divisees verticalement, faites glisser la barre 
separatrice vers la droite pour mieux voir une image zoomee. 

Pour retirer la division d'une fenetre et retourner a une seule vue, faites 
glisser la barre separatrice completement vers la gauche ou vers la droite 
(division verticale), vers le haut ou vers le bas (division horizontale). 
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Lecture de la ligne d'etat 



Vous pouvez obtenir 

les numerosd'indexde 

palette et les valeurs 

RGB en 

double-cliquant sur une 

couleur dans la palette 

Colors. 



Voir la section 

"Personnalisation des 

couleurs", pour plus 

d'informations sur les 

valeurs RGB et les 

index de palette 



La ligne d'etat situee au bas de la fenetre de l'editeur Bitmap est divisee en 
deux parties. Le cote droit fournit des informations sur l'outil de dessin, et le 
cote gauche affiche des informations sur les commandes menus de l'editeur 
Bitmap. 

Lorsque vous cliquez sur un menu, ou utilisez des touches de raccourcis 
pour choisir une commande menu, le cote gauche de la ligne d'etat de 
l'editeur Bitmap affiche des informations supplementaires concernant la 
commande en surbrillance. 

Le cote droit de la ligne d'etat indique l'outil de dessin utilise, et son 
emplacement sur l'ecran. Selon l'outil, vous voyez aussi des informations de 
couleurs. 

Le message d'etat d'outil affiche depend de l'outil selectionne et de son 
emplacement sur l'ecran. Void deux exemples de messages, avec les 
explications afferentes. 

Linex: 18y:32 

Ce message indique que vous avez selectionne l'outil Ligne, et qu'il occupe 
les coordonnees en pixels 18,32. Les coordonnees en pixels sont comptees a 
partir de Tangle superieur gauche de l'image. Lorsque vous vous deplacez 
vers le cote droit de l'image, la valeur X augmente ; lorsque vous vous 
deplacez vers le bas de l'image, la valeur Y augmente. 

Brush x:20 y:37 R:128 G: B:0 Palette Index: 1 

Ce message indique que vous avez selectionne le pinceau, et qu'il occupe les 
coordonnees en pixels 20,37. Les valeurs R, G et B indiquent les valeurs 
rouge, vert, et bleu de la couleur situee a ces coordonnees. La couleur de 
l'image situee aux coordonnees 20,37 est la couleur 1 de l'index de la palette 
Colors, qui comporte une valeur de 128 en composante de rouge, en 
composante de vert et en composante de bleu. 

Vous pouvez aussi voir l'index de palette et les valeurs RGB de la couleur a 
l'emplacement du curseur, si vous selectionnez le stylo, l'aerographe ou la 
boite de peinture. 
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Comment travailler avec les couleurs 



Pour choisir les couleurs desirees lorsque vous editez une ressource dans 
l'editeur Bitmap, utilisez la palette Colors. Vous pouvez travailler avec la 
palette Colors meme si votre image est en noir et blanc, et vous pouvez 
cacher ou afficher la palette Colors a tout moment. 



Figure 19.2 

Palette Colors a 16 

couleurs 



= | Colors 


EH 






















BG 


Transparent Inverted 





Vous pouvez utiliser la palette Colors pour : 

■ Choisir une couleur de premier plan. 

■ Choisir une couleur de fond. 

■ Choisir des zones transparentes et inversees (ressources icone et curseur 
uniquement). 



Choix du nombre 
de couleurs d'une 
ressource 



Certains pilotes 

Windows 3.1 haute 

resolution necessitent 

plus de 512 kode 

memoire. 



Lorsque vous creez un nouveau graphique par points ou une nouvelle 
icone, Resource Workshop affiche une boite de dialogue pour vous 
permettre de choisir le nombre de couleurs que vous voulez inclure dans 
votre ressource. Lorsque vous editez un graphique par points ou une icone, 
vous pouvez changer le nombre de couleurs de l'image avec la commande 
Size and Attributes. Cette commande est situee dans le menu Bitmap ou le 
menu Icon, selon le type de ressource editee. 

Pour les ressources bitmap et icone, vous pouvez inclure jusqu'a 256 
couleurs dans votre ressource. Le nombre de couleurs disponibles 
(apparaissant dans la palette Colors) depend du type de pilote d'affichage 
utilise sous Windows. 
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Utilisation des 
couleurs de 
premier plan et de 
fond 

Si la mention FB 

apparait dans la palette 

Colors, la meme 

couleur est 

selectionnee pour le 

premier plan etle fond. 



Pour utiliser une couleur de premier plan : 

1. Cliquez avec le bouton gauche de la souris sur la couleur voulue dans la 
palette Colors. Les lettres FG apparaissent sur cette couleur. 

2. Selectionnez un outil de dessin et cliquez ou faites glisser le pointeur a 
l'aide du bouton gauche de la souris pour dessiner avec la couleur de 
premier plan. 

Pour utiliser une couleur de fond : 

1. Cliquez avec le bouton droit de la souris sur la couleur voulue dans la 
palette Colors. Les lettres BG apparaissent sur cette couleur. 

2. Selectionnez un outil de dessin et cliquez ou faites glisser le pointeur a 
l'aide du bouton droit de la souris pour dessiner avec la couleur de fond. 

La gomme opere de facon inverse aux outils de dessin. En la faisant glisser 
avec le bouton gauche de la souris, vous produisez la couleur de fond, et 
avec le bouton droit de la souris, vous produisez la couleur de premier plan. 



Zones couleur 
transparentes et 



mversees 



L'idee d'une zone couleur transparente ou inversee est propre aux ressources 
icone et curseur. 

■ Une zone transparente "s'efface" au moment de l'execution, permettant a 
la couleur situee derriere l'icone ou le curseur de transparaitre. Cette 
caracteristique est particulierement utile dans les curseurs, ou vous 
n'utiliserez generalement pas la zone image entiere pour le curseur 
lui-meme. 

■ L'emploi d'une couleur inversee dans votre icone ou curseur "inverse" la 
couleur sur laquelle vous placez l'icone ou le curseur au moment de 
l'execution. 

Par exemple, si vous creez un viseur de curseur a partir d'une couleur 
inversee, le viseur apparaitra au moment de l'execution dans la couleur 
inverse de la zone du bureau au-dessous de lui. Si vous placez le curseur 
au-dessus d'une zone de bureau noire, le viseur apparaitra en blanc. Si 
vous le deplacez au-dessus d'une zone rouge, il apparaitra en bleu sarcelle. 

L'utilisation des zones couleur transparente et inversee est decrite en detail 
dans le chapitre 20, "Creation d'icones", et le chapitre 21, "Creation de 
curseurs" de ce manuel. 
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Definition des 
couleurs 
transparentes et 
inversees 



La boite de dialogue 

est toujours Set 

Transparent Color, que 

vous partiez de la barre 

de couleurs 

Transparent ou de la 

barre de couleurs 

Inverted. 



Les couleurs transparentes et inversees n'apparaissent pas dans votre icone 
ou curseur au moment de l'execution. Elles sont remplacees par la couleur 
du bureau situe en-dessous ou par son inverse. Les couleurs que vous 
definissez avec l'etat Transparent ou Inverse doivent etre des couleurs que 
vous n'utilisez pas dans votre icone ou curseur. 

La couleur transparente par defaut est la couleur du bureau en cours definie 
dans la palette de couleurs du panneau de configuration Windows. Si le 
bureau utilise une couleur trainee, la couleur transparente par defaut est la 
couleur unie la plus proche que Resource Workshop peut fournir. Si vous 
disposez d'un peripherique a 256 couleurs, cette restriction ne s'applique 
pas; la couleur transparente correspondra toujours a la couleur du bureau. 

Vous pouvez changer la couleur transparente en une couleur differente du 
bureau, mais elle revient toujours a la couleur du plan de travail a chaque 
lancement de Resource Workshop. Neanmoins, les regions designees 
comme transparentes, en utilisant la couleur par defaut ou une couleur de 
votre choix, restent transparentes et prennent la couleur transparente en 
cours. Notez cependant que vous pouvez changer les couleurs de telle sorte 
que des regions transparentes et des regions non transparentes utilisent la 
meme couleur. 

Pour changer les couleurs que l'editeur Bitmap affiche pour les zones 
transparentes et inversees, executez une des procedures suivantes : 

■ Dans la palette Colors, double-cliquez sur la barre sous Transparent ou 
Inverted. 

■ Selectionnez Transparent ou Inverted comme couleur de premier plan ou 
de fond. Choisissez ensuite Icon I Edit Foreground Color ou Icon I Edit 
Background Color. 

Resource Workshop affiche la boite de dialogue Set Transparent Color. 

Cette boite de dialogue fonctionne comme la boite de dialogue Edit Colors a 
une exception pres : elle change a la fois les couleurs transparente et 
inversee. 
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Remarquez les trois boites couleur en haut de la boite de dialogue. Lorsque 
vous ajustez les valeurs RGB (Red, Green, Blue), la couleur reelle creee par 
ces pourcentages RGB est affichee dans la boite Requested. La boite Granted 
affiche la couleur disponible la plus proche (pour les peripheriques a 256 
couleurs ou plus, ce sera la couleur Requested), et la boite Inverse montre 
automatiquement son inverse. 

La couleur Granted est affectee a la barre couleur Transparent, et la couleur 
Inverse a la barre couleur Inverted. 



Comment afficher 
et cacher la palette 
Colors 



Pour cacher la palette Colors, fermez-la en double-cliquant sur l'icone du 
menu systeme, dans Tangle superieur gauche de la palette. 

Vous pouvez aussi cacher la palette Colors en choisissant la commande 
Hide Palette. Le nom du menu ou vous trouverez cette commande depend 
du type de ressource en cours d'edition. Si vous editez une icone, la 
commande Hide Palette se trouve dans le menu Icon. Si vous editez un 
curseur, le menu se trouve a la meme position sur la barre menu, mais est 
appele le menu Cursor. 

Une fois que vous avez cache la palette, le nom de la commande devient 
Show Palette pour vous permettre d'afficher a nouveau la palette. 



Personnalisation des couleurs 



Vous ne pouvez pas 

editer les couleurs dans 

les curseurs ou les 

polices. 



Si vous editez un graphique par points ou une icone en couleur, vous 
pouvez modifier la palette Colors pour inclure toute couleur supportee par 
votre pilote d'affichage. Cette operation est inutile si la palette Colors 
comprend deja toutes les couleurs gerees par votre ordinateur. Mais si votre 
pilote d'affichage est capable de restituer 256 couleurs, et que vous travaillez 
avec une image en 16 couleurs, vous pouvez inclure n'importe laquelle des 
256 couleurs dans la palette en 16 couleurs. 

Les sections suivantes decrivent comment editer une des couleurs dans la 
palette Colors, y compris les couleurs transparentes et inversees. 
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Edition de couleurs 
dans la palette 
Colors 



Index de palette 



Pour selectionner une couleur pour l'editer, executez une des procedures 
suivantes : 

Double-cliquez sur la couleur dans la palette Colors. 

■ Selectionnez-la comme couleur de premier plan ou de fond, puis 
choisissez Edit Foreground Color ou Edit Background Color a partir du 
menu Icon ou Bitmap. 

Resource Workshop affiche la boite de dialogue Edit Color. 

Pour vous aider a identifier l'emplacement de la couleur selectionnee dans 
la palette Colors, la boite de dialogue Edit Color comprend une valeur 
d'index de palette. Chaque case de la palette Colors porte un numero 
d'index, en commencant par zero a Tangle superieur gauche et en comptant 
de la gauche vers la droite sur chaque ligne. E)es valeurs d'index ne sont pas 
affectees aux barres Transparent et Inverted dans la palette Colors. 

Par exemple, dans la palette de 16 couleurs par defaut, les couleurs sont 
numerotees conf ormement a la figure suivante : 



Figure 19.3 
Index dela palette 

del 6 couleurs 
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BG 



10 11 12 13 14 15 



Lorsque l'outil selectionne est le stylo, le pinceau, l'aerographe ou la boite 
de peinture, la partie droite de la ligne d'etat affiche l'index de palette et les 
valeurs RGB pour la couleur situee sous la position du curseur dans la 
fenetre d'edition. 



Edition dune 
couleur 

Sur un peripherique 

capable d'afficher 

256 couleurs (ou plus), la 

distinction 

Requested/Granted ne 

s'applique pas. Vous 

voyez des couleurs 

vraies, et non des 

couleurs tramees. 



Pour editer une couleur, vous pouvez modifier ses valeurs RGB, soit en 
tapant de nouvelles valeurs dans la colonne gauche, soit en utilisant les 
barres de defilement, sur le cote droit de la boite de dialogue. Resource 
Workshop affiche la couleur la plus proche correspondant aux nouvelles 
valeurs RGB, dans la boite de couleur Requested. Pour un peripherique de 
16 couleurs, une couleur tramee peut apparaitre dans cette boite. Dans la 
boite de couleur Requested, Resource Workshop affiche la couleur 
disponible la plus proche, selon les limites du peripherique en cours. Vous 
ne pouvez voir cette boite droite changer de couleur que si la 
correspondance la plus proche est differente de la couleur en cours. 
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Lorsque vous avez termine de modifier les couleurs, cliquez sur OK ou 
appuyez sur Entree pour placer la nouvelle couleur dans la palette Colors. 

Avant de quitter l'editeur Bitmap, vous devez desactiver l'option Save With 
Default Device Colors, pour permettre a Resource Workshop d'enregistrer 
votre palette personnalisee. Choisissez Options I Editor Options, et verifiez 
qu'aucune marque de selection n'apparait a cote de Save With Default 
Device Colors. 

Le bouton Default extrait de la palette par defaut (objet standard Windows) 
la couleur portant le meme numero que l'index de palette (affiche dans le 
haut de la boite de dialogue). 

Le bouton System extrait de la palette systeme la couleur portant le meme 
numero que l'index de palette (figurant dans le haut de la boite de 
dialogue). Ce bouton est desactive pour les affichages VGA standard (qui ne 
gerent pas les palettes logiques), mais est active pour les peripheriques qui 
supportent 256 couleurs ou plus. 



Ajout de texte a une ressource 



Vous pouvez ajouter du texte a toute ressource creee avec l'editeur Bitmap. 
Par exemple, vous voudrez peut-etre ajouter du texte a une icone, pour 
representer le nom du programme. 



T 



Pour ajouter du texte a une ressource, cliquez sur l'outil Text (ci-contre), 
puis cliquez dans l'image a l'emplacement ou debutera le texte. Resource 
Workshop affiche un curseur texte clignotant. Enfin, tapez le texte souhaite. 

Pour definir l'alignement, la police, la taille et le style (gras, italique ou 
souligne) par defaut, choisissez Text I Align ou Text I Font avant de taper. 
Pour changer l'alignement, la police, la taille et le style de votre texte, 
choisissez Text I Align ou Text I Font immediatement avant de cliquer la 
souris a nouveau. 

Vous pouvez De plus, immediatement apres la saisie du texte (et avant de cliquer la souris 

uniquement entrer du a nouveau), vous pouvez en modifier la couleur, en selectionnant une 

texte ou changer sa nouvelle cou i eU r dans la palette Colors. 

couleur avec le bouton r 

gauche de la souris. 
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Si vous cliquez sur un autre outil, ou dans une autre zone de l'image, apres 
la saisie du texte, vous ne pouvez rien modifier dans le texte que vous venez 
d'entrer. A ce stade, le texte devient simplement une autre partie du bitmap, 
comme si vous l'aviez dessine. 



Alignement du texte 



Pour aligner du texte, utilisez les commandes Text I Align. 

Les commandes Align controlent l'endroit ou le texte est affiche, par rapport 
au point sur lequel vous avez clique avec l'outil Text (le point d'insertion). 
Vous pouvez utiliser une commande Align avant de taper du texte ou 
immediatement apres. 



Figure 19.4 
Alignement de texte 
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Choix des polices, 
de la taiile et du 
style de texte 



Vous ne pouvez modifier l'alignement du texte que vous venez d'entrer si 
vous avez clique pour effectuer une autre selection. 

Pour choisir l'aspect d'un texte, utilisez la commande Text I Font, soit avant 
d'entrer le texte, soit immediatement apres la saisie. 

Vous ne pouvez modifier la police du texte si vous avez clique pour 
effectuer une autre selection. 

Lorsque vous avez choisi la commande Font, Resource Workshop affiche la 
boite de dialogue Select Font. 

Vous pouvez choisir la police, la taiile et le style de texte souhaites. Par 
exemple, choisissez Arial comme police, 12 points pour la taiile et gras 
italique comme style. 

Notez les caracteres affiches au bas de la boite de dialogue Select Font. lis 
changent pour indiquer la police, le style et la taiile en cours que vous avez 
selectionne. 
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Choix des formes de pinceaux 



Dans une ressource, vous pouvez dessiner des images en utilisant le pinceau 
ou l'aerographe. Resource Workshop vous permet de choisir leur forme. 

La forme du pinceau et de l'aerographe en cours est toujours affichee au bas 
de la palette Tools (voir la section "Selections de style" plus haut dans ce 
chapitre). 

Choisissez une forme de pinceau ou d'aerographe en suivant une des 
methodes ci-dessous : 

■ Pour une forme de pinceau, utilisez Options I Brush Shape. 

■ Pour une forme d'aerographe, utilisez Options I Airbrush Shape. 

■ Cliquez sur la zone representant la forme de pinceau ou d'aerographe en 
cours. 

Une boite de dialogue apparait, et vous indique toutes les formes de 
pinceaux disponibles. Dans le haut de la boite de dialogue, Resource 
Workshop vous signale la forme actuellement selectionnee. 

A la prochaine utilisation du pinceau ou de l'aerographe, Resource 
Workshop utilisera la forme specifiee. Cette forme restera la meme jusqu'a 
la specification suivante. 

Choix des motifs de dessin 

Vous pouvez choisir un motif a dessiner sur votre image, en utilisant un des 
outils suivants : 

■ Le pinceau 

■ L'aerographe 

■ Le rectangle plein 

■ Le rectangle arrondi plein 

■ L'ellipse pleine 
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Notez que la plupart des motifs sont constitues de points ou de lignes noires 
sur un "champ" blanc. Si vous dessinez avec le bouton gauche de la souris, 
les points ou les lignes prennent la couleur de premier plan en cours, et le 
champ prend la couleur de fond en cours. Si vous dessinez avec le bouton 
droit de la souris, l'effet est inverse : les points ou les lignes prennent la 
couleur de fond en cours, et le champ prend la couleur de premier plan en 
cours. 

L'angle inferieur droit de la palette Tools affiche toujours le motif en cours. 

Vous pouvez choisir un motif avec les methodes suivantes : 

■ Choisissez Options I Pattern. 

■ Cliquez sur la zone representant le motif en cours. 

Une boite de dialogue apparait, et vous indique tous les motifs disponibles. 
Au sommet de la boite de dialogue, Resource Workshop vous signale le 
motif actuellement selectionne. Pour selectionner un nouveau motif, cliquez 
sur un des motifs de la boite de dialogue, puis cliquez sur OK. 

A la prochaine utilisation d'un outil capable de restituer un motif, Resource 
Workshop utilise le motif specifie. Ce motif reste le meme jusqu'a la 
specification suivante. 



Choix d'un style de ligne 



Vous pouvez controler le style de ligne produit au moyen d'un des outils 
suivants : 

■ Le stylo 

■ L'outil Ligne 

■ Le rectangle vide 

■ Le rectangle arrondi vide 

■ L'ellipse vide 

Vous pouvez choisir un style de ligne avec les methodes suivantes : 

■ Choisissez Options I Pen Style. 

■ Cliquez sur la selection de style de ligne, dans la palette Tools. 

Une boite de dialogue apparait, et vous indique tous les styles disponibles. 
Dans le haut de la boite de dialogue, Resource Workshop vous signale le 
style actuellement selectionne. 
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Notez le choix "null" de largeur de stylo. Utilisez-le pour dessiner un 
rectangle plein, un rectangle arrondi ou une ellipse sans bordure. 

A la prochaine utilisation d'un outil capable de dessiner une ligne, Resource 
Workshop utilise l'epaisseur specifiee. L'epaisseur de stylo choisie reste la 
meme jusqu'a la prochaine specification. 



Alignement d'une zone selectionnee 



Vous pouvez aligner une zone selectionnee d'une image sur le sommet, le 
bas, les cotes ou le centre de la fenetre d'edition en cours. L' alignement de la 
zone selectionnee la deplace sur l'emplacement specifie, comme si vous 
aviez selectionne la zone, puis deplace avec la souris. Pour aligner une zone 
selectionnee, choisissez Options I Align, puis les options voulues dans la 
boite de dialogue Align Selection. 

Choisissez les options sous le mot Vertical, pour aligner la zone selectionnee 
sur l'axe vertical de la fenetre d'edition, et les options sous le mot Horizontal 
pour l'aligner sur l'axe horizontal. 

Par exemple, si vous choisissez Top et Left Side et que vous cliquez sur OK, 
la zone selectionnee se deplace sur Tangle superieur gauche de la fenetre. Si 
vous choisissez Vertical I Center et Right Side et cliquez sur OK, la zone 
selectionnee est centree entre le sommet et le bas de la fenetre, et elle est 
deplacee aussi loin vers la droite que possible. 

L'editeur Bitmap utilise la couleur de fond en cours pour peindre 
l'emplacement qu'occupait la zone selectionnee, comme il l'aurait fait si 
vous aviez deplace la zone selectionnee avec la souris. 

Redimensionnement d'une zone selectionnee 

Vous pouvez redimensionner ou deplacer une zone d'image selectionnee 
avec l'outil Pick Rectangle, en choisissant Options I Size. Si vous 
redimensionnez la zone, l'editeur Bitmap dilate ou comprime en 
consequence l'image de la zone de selection. 

Lorsque vous choisissez Options I Size, l'editeur Bitmap affiche la boite de 
dialogue Stretch Selection. 



Chapitre 19, Comment utiliser l'editeur Bitmap 365 



Les valeurs Top et Left de cette boite de dialogue sont les coordonnees en 
pixels de Tangle superieur gauche de la zone actuellement selectionnee, et 
les autres valeurs representent sa largeur et sa hauteur en cours (en pixels). 
Lorsque la boite de dialogue s'ouvre, les memes valeurs apparaissent a la 
fois dans les colonnes Old Position I Size et New Position I Size. 

Pour deplacer ou redimensionner la zone (ou les deux), reprenez des 
valeurs en pixels qui tombent dans les limites du cadre en cours. Entrez-les 
dans les boites sous la rubrique New Position I Size. Appuyez sur Tab pour 
passer d'un champ a l'autre. 

Par exemple, pour deplacer une zone rectangulaire sur Tangle superieur 
gauche, et lui dormer une largeur de 30 pixels et une hauteur de 5 pixels, 
procedez comme suit : 

1. A Taide de Toutil Rectangle de selection, definissez la zone a deplacer ou 
a redimensionner. 

2. Entrez comme valeur pour Left, puis appuyez sur Tab. 

3. Entrez comme valeur pour Top, et appuyez sur Tab. 

4. Entrez 30 comme largeur, et appuyez sur Tab. 

5. Entrez 5 comme hauteur. 

6. Cliquez sur OK, ou appuyez sur Entree. 

La boite est maintenant positionnee dans Tangle superieur gauche du cadre, 
avec les nouvelles largeur et hauteur. De plus, Tediteur Bitmap remplit toute 
zone ouverte situee auparavant derriere la boite avec la couleur de fond en 
cours, comme il Taurait fait si vous aviez deplace le rectangle de selection 
avec la souris. 

Choix des options globales de Tediteur Bitmap 

Pour definir les options globales de Tediteur Bitmap, choisissez 

Options I Editor Options pour afficher la boite de dialogue Set Paint Editor 

Options. 



Draw on both Lorsque deux vues d'une meme image sont affichees dans Tediteur Bitmap, 

images vous pouvez choisir que Resource Workshop actualise chaque image 

pendant que vous dessinez. 
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Si vous ne choisissez pas cette option, Resource Workshop n'actualise pas 
l'autre image tant que vous n'avez pas termine de dessiner un element. Par 
exemple, lorsque vous faites glisser un pinceau dans l'image, Resource 
Workshop n'affiche la ligne que sur l'image reellement dessinee. 
Cependant, lorsque vous relachez le bouton de la souris, Resource 
Workshop actualise alors l'autre image. 



Grid on zoomed 
windows 



Sur des fenetres zoomees, vous pouvez afficher une grille qui indique 
comment l'image est dessinee, pixel par pixel. 



Save with default 
device colors 



Desactivez cette option si vous voulez enregistrer une palette de couleurs 
personnalisee. Lorsque cette option est activee, toute couleur personnalisee 
dans la palette Colors revient a la couleur par defaut, lorsque vous refermez 
l'editeur Bitmap. 

Vous ne pouvez enregistrer des palettes de couleurs personnalisees que si 
votre pilote d'affichage peut afficher 256 couleurs, et s'il accepte les palettes 
logiques. Pour plus de details, reportez-vous a la section "Personnalisation 
des couleurs", plus haut dans ce chapitre. 
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Creation d'icones 



Les icones sont des petites images bitmap, de taille 64 x 64, 32 x 32 ou 32 x 16 
pixels. En general, les programmes Windows ont recours a des icones 
speciales pour representor des fenetres reduites. 

Pour concevoir vos icones, utilisez l'editeur Bitmap de Resource Workshop. 

L'editeur Bitmap comprend divers outils de dessin, et une palette Colors 
d'emploi facile pour selectionner les couleurs. II vous permet aussi de 
zoomer votre image, et affiche plusieurs vues de l'icone creee. Le chapitre 19 
explique comment utiliser l'editeur Bitmap. 

Travailler avec des icones implique quatre etapes principales : 

1. Lancer l'editeur Bitmap. 

Si vous creez une nouvelle ressource icone, l'editeur Bitmap vous 
presente une grille icone vide. Si vous modifiez une icone existante, elle 
apparait dans l'editeur Bitmap. 

2. Creer ou modifier l'icone. 

3. Tester l'icone. 

4. Enregistrer l'icone. 



Creation d'une nouvelle icone 



Vous pouvez ajouter une nouvelle icone dans un fichier projet, ou creer un 
fichier icone autonome d'extension .ICO. 



Ajout d'une icone Pour ajouter une icone dans un fichier .RC (ou .DLG) : 

dans un fichier „ _ „,.«.■,,.-, 

Dro j e j 1. Ouvrez un nouveau projet ou un projet existant (le chapitre 14 decrit la 

procedure d'ouverture d'un projet). 

2. Choisissez Resource I New. Resource Workshop affiche la boite de 
dialogue New Resource. 
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Les ressources 

integrees et liees sont 

traitees a la section 

"Ressources integrees 

ou liees" duchapitre 14. 



Voir la section "Choix 

du nombre de couleurs 

d'une ressource" du 

chapitre 19 pour une 

description des formats 

de couleurs. 

Creation d'un 
fichier icone 
autonome 



3. Faites defiler la boite liste Resource Type et selectionnez ICON. 

Le nom du fichier projet en cours apparait dans la boite sous la rubrique 
"Place resource in". Vous pouvez faire defiler le contenu de cette liste 
pour choisir un autre fichier, ou cliquer sur OK pour accepter le fichier 
projet en cours. 

4. Resource Workshop vous demande si vous voulez creer l'icone au 
format source ou au format binaire compatible Microsoft. 

Choisissez Source pour creer une icone integree dans le fichier projet. 
Resource Workshop affiche alors la boite de dialogue New Icon. 

Si vous choisissez Binary, vous creez un fichier .ICO autonome (voir la 
section suivante). 

5. La boite de dialogue New Icon Image vous demande de specifier la taille 
(en pixels) de la nouvelle icone et le nombre de couleurs a gerer. Si le 
Presse-papiers de Windows contient une image en mode point, les 
caracteristiques de celle-ci (dimensions et couleurs) deviennent les 
valeurs par defaut. 

Choisissez la taille d'image et le format de couleur desire, puis cliquez 
sur OK. Resource Workshop place le nom de la nouvelle icone dans la 
fenetre projet et lance l'editeur Bitmap. 



Vous pouvez creer un fichier icone autonome en executant une des 
procedures suivantes : 

■ Choisir Binary dans la boite de dialogue qui vous demande si vous voulez 
creer votre icone au format Source ou Binary. 

■ Choisir File I New Project et selectionner .ICO dans la boite de dialogue 
New Project. 

Pour lier un fichier icone autonome a un fichier projet, ouvrez le fichier 
projet, puis choisissez File I Add to Project (voir la section "Ajout d'une 
ressource" du chapitre 14). 
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Option de format Lorsque vous choisissez le format Binary, Resource Workshop affiche la 

Binai V boite de dialogue New File Resource afin de nommer votre fichier icone et 

specifier le projet dans lequel il sera reference. Lorsque le type de ressource 
selectionne est une icone, la boite de saisie File Name indique *.ICO. 

1. Entrez un nom pour votre fichier .ICO dans la boite de saisie File Name. 
Assurez-vous que le nom de votre projet apparait dans la boite liste 
intitulee "A reference to the resource...". Pour changer le repertoire de 
stockage du fichier, definissez le chemin en double-cliquant sur les 
icones appropriees dans la boite liste Directories. Le chemin choisi est 
affiche dans la boite de saisie Path. 

2. Lorsque vous avez effectue vos selections, cliquez sur OK. Resource 
Workshop affiche une boite de dialogue vous specifiant que le fichier 
nomme n'existe pas, et vous demandant si vous voulez creer le fichier. 
Cliquez sur Yes. 

3. Lorsque vous quittez la boite de dialogue New File Resource, Resource 
Workshop affiche la boite de dialogue New Icon Image. Lorsque vous 
selectionnez les couleurs et la taille de l'icone, Resource Workshop lance 
l'editeur Bitmap. 

Vous pouvez aussi choisir un nom de fichier dans la boite liste Files. Dans ce 
cas, vous ecraserez le fichier existant. Par precaution, Resource Workshop 
vous demande si vous voulez ecraser le fichier. 



Fichier projet icone Si vous choisissez File I New Project et selectionnez .ICO dans la boite de 
dialogue New Project, vous creez automatiquement un fichier icone 
autonome. Resource Workshop affiche immediatement la boite de dialogue 
New Icon Image. Apres avoir specifie les couleurs et la taille, Resource 
Workshop lance l'editeur Bitmap. 

Edition des icones 

Les sections suivantes decrivent plusieurs techniques d'edition de vos 
icones. 



Visualisation La resolution standard EGA/VGA est de 32 x 32, mais vous pouvez creer 

d autres resolutions des icones selon deux autres resolutions : 32 x 16 et 64 x 64. Le menu View 

comprend des commandes qui vous permettent de visualiser l'icone selon 

d'autres resolutions d'affichage. 
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■ Si vous creez l'icone en resolution 32 x 32, la commande View I CGA 
Resolution [32 x 16] vous permet de voir l'aspect de l'icone sur un ecran 
CGA. 

■ Si vous creez l'icone en resolution 32 x 16 (CGA), la commande 
View I EGA- VGA Resolution [32 x 32] vous permet de voir l'aspect de 
l'icone sur un ecran EGA ou VGA. 

■ Si vous creez l'icone en resolution 64 x 64, les deux commandes sont 
disponibles. Vous pouvez voir l'aspect de l'icone sur un ecran CGA, ou 
bien sur un ecran EGA ou VGA. 

Pour sortir de ces modes de visualisation, choisissez View I Actual Size. 

Avec ces commandes, vous ne changez que la vue de l'icone, et non l'icone 
elle-meme. Elle est toujours de meme resolution. 



Utilisation des 
zones couleur 
transparentes et 
inversees 



Les couleurs inversees 

sont generalement plus 

utiles pour les curseurs 

que pour les icones. 



Comme specifie a la section "Zones couleur transparentes et inversees" du 
chapitre 19, vous pouvez utiliser des zones couleur transparentes et 
inversees dans vos icones. Au moment de l'execution, la zone transparente 
"s'efface" et laisse apparaitre la couleur du bureau au-dessous. Toute partie 
de l'icone peinte avec une couleur inversee prend la couleur opposee du 
bureau au-dessous : blanc sur noir, sarcelle sur rouge, par exemple. 

Lorsque vous commencez une nouvelle icone, il s'agit initialement d'une 
grille constitute entierement de la couleur transparente en cours. Si vous 
dessinez une simple ligne d'une autre couleur sur la grille, puis testez 
l'icone, vous verrez cette ligne sur le bureau, mais vous ne verrez pas le 
contour de la grille ni la zone remplie avec la couleur transparente. 



Ajout d'une image a une ressource icone 



En general, vous creez une nouvelle ressource icone pour chaque conception 
d'icone (appelee simplement icone), et vous ne placez pas differentes icones 
dans la meme ressource icone. Cependant, il est probable que vous voudrez 
placer divers formats de couleur de la meme icone dans la meme ressource 
icone. Ces differences de couleur sur la meme icone sont appelees images. 
Par exemple, si vous voulez une version bicolore et une version en 16 
couleurs de la meme conception d'icone, vous pouvez les stocker dans la 
meme ressource icone. 
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La ressource icone accepte divers formats de couleur. En effet, Windows 
choisit un format de couleur selon la capacite du materiel d'affichage a gerer 
le format. Windows choisit un format bicolore pour un pilote d'affichage 
monochrome, et un format en 16 couleurs pour le pilote VGA Windows 
standard. 

Windows 3.x ne supporte pas entierement la version en 256 couleurs d'une 
icone, meme si votre materiel d'affichage l'accepte. Votre programme doit 
assurer lui-meme la gestion des 256 couleurs. 

Void comment ajouter une nouvelle image a une ressource icone existante. 

1. Ouvrez un projet. 

2. Double-cliquez sur l'entree ICON dans la fenetre projet, ou selectionnez 
l'entree ICON, puis choisissez Resource I Edit. Resource Workshop 
affiche la fenetre Icon. 



Figure 20.1 
Fenetre icone 
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5. 



Pour creer une nouvelle version d'une icone existante, choisissez 
Images I New Image. Resource Workshop affiche la boite de dialogue 
New Icon Image dans laquelle vous pouvez choisir la taille de l'image et 
le format de couleur. 

Choisissez la meme taille que l'image existante et un nouveau format de 
couleur, puis cliquez sur OK. Resource Workshop affiche la nouvelle 
entree image dans la fenetre Icon. 

Double-cliquez sur la nouvelle icone, ou bien selectionnez-la et choisissez 
Image I Edit Image. Vous verrez alors l'editeur Bitmap. 

De facon typique, l'etape suivante consiste a ouvrir l'une des images 
icone existantes, et a la copier dans la nouvelle image (encore vierge). 
Vous pouvez aussi vouloir editer l'image si les couleurs sont restituees 
avec une modification de la forme de l'icone. 
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Modification des attributs d'une icone 



Pour changer les attributs (resolution ou format de couleur) de l'image icone 
en cours, executez la procedure suivante : 

1. Choisissez Icon I Size and Attributes pour afficher la boite de dialogue 
Icon Image Attributes. 

A l'exception d'un bouton-poussoir supplementaire (decrit ci-apres), la 
boite de dialogue Icon Image Attributes est identique a la boite de 
dialogue New Icon Image. 

2. Selectionnez une resolution ou un format de couleur, puis cliquez sur 
OK. 

La modification des attributs d'une icone change reellement l'icone, par 
opposition a la visualisation de l'icone a d'autres resolutions. 



Affichage des 

informations 

peripherique 



Le bouton-poussoir supplementaire de la boite de dialogue Icon Image 
Attributes est appele Device Info. Lorsque vous cliquez sur ce bouton, 
Resource Workshop affiche la boite de dialogue Display Device Information, 
qui fournit les informations suivantes sur votre peripherique d'affichage : 

■ Nombre de bits par pixel 

■ Nombre de plans de couleurs 

■ Nombre de couleurs gerees 

■ S'il s'agit d'un peripherique palette 

Si le peripherique supporte les palettes couleur logiques, la boite de 
dialogue Display Device Information enumere les informations suivantes : 

■ Le nombre d'entrees dans la palette systeme 

■ Le nombre d'entrees reservees dans la palette systeme 

■ La resolution couleur du peripherique en bits par pixel 
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Creation d'une icone exemple 



=■ — fe 



Le chapitre 14 decrit la 

procedure d'ouverture 
d'un projet. 



Cette section explique comment creer un exemple d'icone represente 
ci-contre. 

Pour creer la nouvelle icone, vous devez d'abord ouvrir un projet, puis 
suivre une serie d'etapes pour afficher l'editeur Bitmap contenant la 
nouvelle image vierge. 

1. Choisissez File I New Project pour creer un nouveau projet, ou 
File I Open Project pour ouvrir un projet existant. 

2. Choisissez Resource I New, et indiquez a Resource Workshop qu'il doit 
creer une nouvelle ressource. Lorsque Resource Workshop vous 
demande le type de ressources souhaite, choisissez ICON. 

3. Choisissez Source pour stocker l'icone en tant que script ressource dans 
le fichier .RC. 

4. Resource Workshop ouvre la boite de dialogue New Icon Image. Activez 
32x32 et 16 Colors, puis cliquez sur OK. 

5. Resource Workshop ouvre l'editeur Bitmap. 



Dessin de la 
calculatrlce 



Pour dessiner l'icone calculatrice : 

1. Choisissez Options I Editor Options. Activez Grid On Zoomed 
Windows, pour vous aider a aligner les touches de la calculatrice, puis 
cliquez sur OK. 

La grille vous indique les pixels individuels lorsque vous zoomez votre 
icone dans l'editeur Bitmap. II est plus facile de voir ce que vous dessinez 
sur une vue agrandie de l'icone. 

2. Gardez l'icone affichee en taille reelle dans la fenetre droite. Pour zoomer 
l'image de la fenetre gauche, double-cliquez sur l'icone Zoom, dans la 
palette Tools, jusqu'a ce que l'image atteigne la taille maximale, tout en 
restant visible sur l'ecran. 

Sur la vue zoomee, chaque carre de la grille represente un pixel. 

Main tenant vous pouvez dessiner. 

3. Choisissez le rouge sombre pour la calculatrice. Lorsque vous cliquez 
dans la palette Colors, les lettres FG (foreground, premier plan) 
apparaissent sur cette couleur. 
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Veillez a laisser deux 

pixels sous la 

calculatrice, pour placer 

I'ombrage. 



4. Cliquez sur le rectangle plein de la palette Tools. Cet outil carre est situe 
a droite, sous l'outil Text (le grand "T"). 

5. Dessinez la calculatrice dans la partie inferieure gauche de l'icone. 

Vous pouvez utiliser le rectangle plein pour dessiner toutes les parties de la 
calculatrice : la face avant, la zone d'affichage et les touches. Choisissez 
diverses couleurs pour ces elements, en cliquant dans la palette Colors avant 
de dessiner (essayez le jaune pour les touches et le cyan sombre pour 
l'ecran). Lorsque vous avez termine, doit ressembler a ceci : 



Figure 20.2 

Calculatrice avant 

I'ajout de I'ombre 

portee 






Si vous commettez une erreur, vous pouvez utiliser la fonction de 
suppression (Edit I Undo ou Alt+Retour arriere) pour la rectifier. Vous 
pouvez aussi utiliser l'outil Rectangle de selection ou l'outil Ciseaux, pour 
delimiter une zone et l'effacer (utilisez la touche Suppr ou Edit I Delete). 
Enfin, vous pouvez utiliser la gomme. 

Si vous voulez tout effacer et recommencer, double-cliquez simplement sur 
la gomme de la palette Tools. 



Ajout d'un effet a 
trois dimensions 



Pour ajouter un effet a trois dimensions a la calculatrice : 

1. Choisissez la couleur noire pour I'ombre. 

2. Utilisez l'outil Ligne pour remplir une ligne ombree, sur le cote et sous la 
calculatrice. La ligne doit avoir une epaisseur de deux pixels, debuter 
deux pixels au-dessous du sommet, et se terminer a deux pixels du cote 
gauche. 

3. Vous pouvez aussi donner un aspect en trois dimensions a la fenetre 
calculatrice en dessinant une ligne blanche le long du bord gauche de la 
fenetre et de son sommet. 
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Void a quoi ressemblerait maintenant la calculatrice. 



Figure 20.3 

Calculatrice avec 

effet d'ombre 



m 



Lorsque vous avez termine de dessiner la calculatrice, choisissez File I Save 
Project pour enregistrer votre nouvelle image icone. II est toujours judicieux 
d'enregistrer frequemment. 



Dessin de la page 
du livre de comptes 



Pour dessiner la page du livre de comptes : 

1. Choisissez le noir, puis l'outil Ligne. 

2. Utilisez l'outil Ligne pour dessiner une ligne noire verticale. Commencez 
sur le cinquieme pixel a gauche de Tangle superieur droit de la 
calculatrice. Poursuivez la ligne jusqu'au sommet de la fenetre d'edition, 
puis jusqu'a son angle superieur droit, et redescendez deux pixels 
au-dessus du bas de l'editeur Bitmap. Enfin, continuez jusqu'a atteindre 
l'ombrage noir a droite de la calculatrice. Vous venez de dessiner le 
contour de la page du livre de comptes. 

Choisissez la couleur blanche et selectionnez l'outil Boite de peinture. 
Cliquez la boite de peinture sur la page du livre de comptes, pour la 
remplir de blanc. 

Choisissez cyan (le bleu le plus clair) et l'outil Ligne. 
Cliquez sur la case du style de ligne dans Tangle inferieur droit de la 
palette Tools. Dans la boite de dialogue Current Pen Style, choisissez 
Tepaisseur de ligne de deux pixels (a droite de Null). 



3. 
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Utilisez la commande 

Edit | Undo pour 

corriger les erreurs. 



6. Commencez deux pixels au-dessus du bas de la page du livre de 
comptes, et a un pixel de l'endroit ou vous voulez commencer la ligne 
(deux pixels de large), dessinez une serie de lignes hautes de deux pixels, 
au travers de la partie visible de la page. Chaque ligne doit etre espacee 
de deux pixels. Les trois lignes inferieures seront reliees sur la gauche 
par l'ombrage de la calculatrice. 

7. Choisissez le rouge clair et l'outil Ligne. 

8. Cliquez sur le style Ligne, dans Tangle inferieur droit de la palette Tools. 
Dans la boite de dialogue Current Pen Style, choisissez l'epaisseur de 
ligne d'un pixel (au-dessus de Null). 

9. En commencant a trois pixels du bord droit du livre de comptes, 
dessinez une ligne verticale aussi longue que la page du livre. A une 
distance de quatre pixels sur la gauche, dessinez une seconde ligne 
verticale rouge. 

10. Choisissez le noir et dessinez une ligne horizontale debutant 
immediatement au-dessus de la zone superieure cyan, et parcourant la 
largeur de la page du livre de comptes. 

11. Lorsque vous avez termine votre icone, la fenetre de l'editeur Bitmap 
aura 1' aspect suivant : 



Figure 20.4 

Icone Home Budget 

terminee 
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Creation de curseurs 



Les curseurs sont des images bitmap d'une taille de 32x32 pixels qui 
representent l'emplacement en cours du pointeur de la souris sur l'ecran. 
Une application Windows comporte souvent un certain nombre de curseurs 
differents qui representent differentes fonctions du programme. 

Windows procure un ensemble de curseurs standard que vous utilisez dans 
vos programmes. De plus, vous pouvez creer vos propres curseurs speciaux 
pour representer diverses fonctions. Un de ces curseurs speciaux est le 
curseur Boite de peinture de Resource Workshop qui s'affiche lorsque vous 
choisissez un outil Boite de peinture dans l'editeur Bitmap (decrit au 
chapitre 19). 

L'editeur Bitmap comprend de nombreux outils de dessin, et une palette 
Colors qui facilite la selection des couleurs. II vous permet aussi de zoomer 
une image, et montre de nombreuses vues du curseur cree. 

Travailler avec des curseurs implique quatre etapes principales 

1. Lancer l'editeur Bitmap 

Si vous creez une nouvelle ressource curseur, l'editeur Bitmap vous 
presente une grille curseur vide. Si vous modifiez un curseur existant, il 
apparait dans l'editeur Bitmap. 

2. Creer ou modifier le curseur. 

3. Tester le curseur. 

4. Enregistrer le curseur. 
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Creation d'un nouveau curseur 



Vous pouvez ajouter un nouveau curseur dans un fichier projet, ou creer un 
fichier curseur autonome avec l'extension .CUR. 



Ajout d'un curseur 
dans un fichier 
projet 

La boite de dialogue 

New Resource est 

decrite a la section 

"Ajout d'une ressource" 

duchapitre 14. 



Les ressources 

integrees et liees sont 

traitees a la section 

"Ressources integrees 

ou liees" du chapitre 14. 



Pour ajouter un curseur dans un fichier .RC (ou .DLG) 

1. Ouvrez un nouveau projet ou un projet existant (le chapitre 14 decrit la 
procedure d'ouverture d'un projet). 

2. Choisissez Resource I New. Resource Workshop affiche la boite de 
dialogue New Resource. 

3. Selectionnez CURSOR dans la boite liste Resource Type. 

Le nom du fichier projet en cours apparait dans la boite sous la rubrique 
"Place resource in". Vous pouvez faire defiler le contenu de cette liste 
pour choisir un autre fichier, ou cliquez sur OK pour accepter le fichier 
projet en cours. 

4. Resource Workshop vous demande si vous voulez creer le curseur au 
format source ou au format binaire compatible Microsoft. 

5. Choisissez Source pour creer un curseur integre dans le fichier projet. 
Resource Workshop lance alors l'editeur Bitmap. 

Si vous choisissez Binary, vous creez un fichier .CUR autonome (voir la 
section suivante). 



Creation d'un 
fichier curseur 
autonome 



Vous pouvez creer un fichier curseur autonome en executant une des 
procedures suivantes 

■ Choisir Binary dans la boite de dialogue qui vous demande si vous voulez 
creer votre curseur au format Source ou Binary (voir la figure 9.3). 

■ Choisir File I New Project et selectionner .CUR dans la boite de dialogue 
New Project. 

Pour lier un fichier curseur autonome a un fichier projet, ouvrez le fichier 
projet, puis choisissez File I Add to Project (voir la section "Ajout d'une 
ressource" du chapitre 14). 
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Option de format Lorsque vous choisissez le format Binary, Resource Workshop affiche la 

Binai V boite de dialogue New File Resource afin de nommer votre fichier curseur et 

specifier le projet dans lequel il sera reference. Lorsque le type de ressource 
selectionne est un curseur, la boite de saisie File Name indique *.CUR. 

1. Entrez un nom pour votre fichier .CUR dans la boite de saisie File Name. 
Assurez-vous que le nom de votre projet apparait dans la boite liste 
intitulee "A reference to the resource...". Pour changer le repertoire de 
stockage du fichier, definissez le chemin en double-cliquant sur les 
icones appropriees dans la boite liste Directories. Le chemin choisi est 
affiche dans la boite de saisie Path. 

2. Lorsque vous avez effectue vos selections, cliquez sur OK. Resource 
Workshop affiche une boite de dialogue vous specifiant que le fichier 
nomme n'existe pas, et vous demandant si vous voulez creer le fichier. 
Cliquez sur Yes. 

3. Lorsque vous quittez la boite de dialogue New File Resource, Resource 
Workshop lance l'editeur Bitmap. 

Vous pouvez aussi choisir un nom de fichier dans la boite liste Files. Dans ce 
cas, vous ecraserez le fichier existant. Par precaution, Resource Workshop 
vous demande si vous voulez ecraser le fichier. 

Fichier projet Si vous choisissez File I New Project et selectionnez .CUR dans la boite de 

curseur dialogue New Project, vous creez automatiquement un fichier curseur 

autonome. Resource Workshop lance immediatement l'editeur Bitmap. 

Edition des curseurs 

Les sections suivantes decrivent plusieurs techniques d'edition de vos 
curseurs. 



Palette Colors pour La palette Colors pour les curseurs differe de celle des autres ressources 
les curseurs bitmap en un point important seules deux couleurs de premier plan et de 

fond sont disponibles, le noir et le blanc. Un curseur typique consiste en une 
forme blanche (une fleche ou un point d'interrogation, par exemple) avec un 
contour noir. 
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Comment travailler 
avec les zones 
transparentes et 
inversees 



Comme specifie a la section "Zones couleur transparentes et inversees" du 
chapitre 19, vous pouvez utiliser des zones couleur transparentes et 
inversees dans vos curseurs. Au moment de l'execution, la zone 
transparente "s'efface" et laisse apparaitre la couleur du bureau au-dessous. 
Toute partie du curseur peinte avec une couleur inversee prend la couleur 
opposee du bureau au-dessous blanc sur noir, sarcelle sur rouge, par 
exemple. Les couleurs inversees sont generalement utilisees pour le "point 
actif" du curseur. 

Lorsque vous commencez un nouveau curseur, il s'agit initialement d'une 
grille constitute entierement de la couleur transparente en cours. Si vous 
dessinez une simple ligne d'une autre couleur sur la grille, puis testez le 
curseur, vous verrez cette ligne sur la couleur du bureau, mais vous ne 
verrez pas le contour de la grille ni la zone remplie avec la couleur 
transparente. 

Ne specifiez pas noir et blanc pour les couleurs inversees ou transparentes, 
ou bien votre curseur ne sera pas visible au moment de l'execution ou 
changera constamment de couleur a tout deplacement de la souris sur la 
surface d'application. 



Reglage du point 
actif du curseur 



Lorsque vous editez un curseur, il est important de determiner le point actif 
du curseur. Le point actif est le pixel du curseur qui fixe l'emplacement ou 
l'utilisateur place le curseur et clique pour faire une selection. 

Pour definir un point actif, determinez ses coordonnees exactes en pixels. Ce 
sont des unites horizontals (x) et verticales (y). Le pixel superieur gauche 
de l'image curseur est x=0 et y=0. Le pixel inferieur droit d'un curseur de 32 
x 32 est x=31 et y=31, et pour un curseur de 32 x 16, x=31 et y=15. 

Pour definir le point actif, suivez les etapes ci-dessous 

1. Le curseur apparaissant dans l'editeur Bitmap, zoomez en avant sur 
l'image curseur jusqu'a ce qu'elle soit suffisamment grande pour vous 
permettre de choisir precisement les coordonnees en pixels du point actif. 

2. Verifiez que la grille est affichee sur l'image zoomee. Le cas echeant, 
choisissez Options I Editor Options, et activez Grid On Zoomed 
Windows. 

3. Selectionnez un outil de dessin vous permettant de pointer precisement 
sur un pixel. L'outil Ligne est un bon choix, car il comprend un viseur 
indiquant exactement l'emplacement du point actif. 
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4. Avec l'outil choisi, pointez, sur l'image agrandie, l'emplacement souhaite 
pour le point actif . Examinez les coordonnees affichees sur la ligne d'etat, 
et notez-les. 

5. Choisissez Cursor I Set Hot Spot, et tapez les coordonnees. 
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Creation de polices 



Ce manuel utilise les 

termes "police" et 

"ressource police" de 

facon interchangeable. 



Selon la definition standard, une police est un jeu de caracteres de taille et 
d'un style donne. Une ressource police est une collection de donnees utilisee 
par un ordinateur pour dessiner des images bitmap individuelles (lettres ou 
autres caracteres) sur un peripherique de sortie, tel qu'un moniteur 
d'affichage ou une imprimante. 

La police contient des donnees qui decrivent la collection generale d'images, 
comme le nom de la police, la taille suggeree, le jeu de caracteres, les lettres 
de la police, etc. La police contient aussi des informations necessaires a 
l'ordinateur pour dessiner chaque image bitmap. 

Travailler avec des ressources police implique cinq etapes principales : 

1. Lancer l'editeur Paint en chargeant une nouvelle police ou une police 
existante. 

2. Creer ou editer une image police avec l'editeur Paint. 

3. Enregistrer la ressource police en tant que partie du fichier projet, ou 
dans un fichier distinct. 

4. Quitter Resource Workshop et ajouter la ressource police dans une DLL 
(ressource uniquement) specifique avec l'extension .FON. 

5. Inserer un appel au fichier .FON dans votre programme, le compiler, et 
tester la ressource police. 
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Types de polices 



Windows supporte deux types de polices : les polices trainees et les polices 
vectorielles. Resource Workshop cree et edite uniquement les polices 
trainees. 

■ Les polices trainees contiennent une image bitmap pour chaque caractere. 

■ Les polices vectorielles contiennent des commandes de dessin pour 
chaque caractere. Generalement, elles contiennent aussi des "conseils" 
pour produire des images de meilleure qualite a des tailles differentes. Les 
polices vectorielles acceptees par Windows ne comportent pas ces 
conseils. Ces polices limitees sont appelees polices vecteur, dont Roman, 
Script et Modern sont des exemples. En tant qu'utilisateur Windows, vous 
disposez d'une technologie de police plus sophistiquee, grace aux 
generateurs de polices de fournisseurs tierce partie. 



Pourquoi placer Vous pouvez utiliser Resource Workshop pour creer des lettres 

des bitmaps dans personnalisees. Cependant, vous voudrez que ce travail soit effectue par un 

une police package specialise de developpement de polices. Vous utiliserez 

probablement Resource Workshop pour creer des polices image bitmap : de 

petits graphiques par points a grouper ensemble. 

Dans certains cas, les ressources police et les ressources bitmap ne sont pas 
interchangeables. Si vous creez un pinceau pour peindre une zone de 

*l'ecran, vous devrez le creer comme une ressource bitmap. Pour creer des 
images bitmap pour les afficher simplement a l'ecran, telle qu'une bombe ou 
un panneau STOP, vous pourriez utiliser les ressources bitmap ou les 
ressources police. Par exemple, cette image de bombe a ete creee en tant que 
ressource police. 

Plusieurs raisons peuvent vous amener a definir des images en tant que 
partie d'une ressource police au lieu de ressources bitmap distinctes : 

■ II est plus facile d'ecrire du code Windows pour charger une police en 
memoire et la dessiner, que de charger et de dessiner la meme image 
stockee en tant que graphique par points. 

■ Une police peut stocker jusqu'a 256 graphiques par points. Si votre 
programme utilise generalement un certain ensemble d'images bitmap en 
meme temps, vous pouvez ranger ces images dans une ressource police, et 
le programme peut alors charger uniquement cette ressource lorsqu'il a 
besoin de cet ensemble d'images. 
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■ Une police peut stocker plusieurs images de maniere plus efficace que le 
stockage des memes images en tant que ressources bitmap separees. 

Notez cependant qu'une ressource police dispose d'une certaine quantite de 
memoire au debut de celle-ci. A chaque chargement d'une police en 
memoire, Windows charge aussi l'en-tete de police (voir la section 
"Definition d'un en-tete pour une ressource police" plus loin dans ce 
chapitre). Si vous creez une seule image et ne savez pas si vous devez la 
definir en tant que ressource police ou ressource bitmap, choisissez 
"ressource bitmap" si une utilisation efficace de la memoire est importante. 



Creation d'une nouvelle ressource police 



Vous pouvez ajouter une nouvelle ressource police dans un fichier projet, ou 
creer un fichier police autonome avec l'extension .FNT. 



Ajout d'une police 
dans un fichier 
projet 



Les ressources 

integrees et liees sont 

traitees a la section 

"Ressources integrees 

ou liees" du chapitre 14. 



Pour ajouter une police dans un fichier .RC (ou .DLG) : 

1. Ouvrez un nouveau projet ou un projet existant (le chapitre 14 decrit la 
procedure d'ouverture d'un projet). 

2. Choisissez Resource I New. Resource Workshop affiche la boite de 
dialogue New Resource. 

3. Selectionnez FONT dans la boite liste Resource Type. 

Le nom du fichier projet en cours apparait dans la boite sous la rubrique 
"Place resource in". Vous pouvez faire defiler le contenu de cette liste 
pour choisir un autre fichier, ou cliquez sur OK pour accepter le fichier 
projet en cours. 

4. Resource Workshop vous demande si vous voulez creer la police au 
format source ou au format binaire compatible Microsoft. 

Choisissez Source pour creer une police integree dans le fichier projet. 
Resource Workshop lance alors l'editeur Paint. 

Si vous choisissez Binary, vous creez un fichier .FNT autonome (voir la 
section suivante). 
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Creation d'un 
fichier police 
autonome 



Option de format 
Binary 



Vous pouvez creer un fichier police autonome en executant une des 
procedures suivantes : 

■ Choisir Binary dans la boite de dialogue qui vous demande si vous voulez 
creer votre police au format Source ou Binary. 

■ Choisir File I New Project et selectionner .FNT dans la boite de dialogue 
New Project. 

Pour lier un fichier police autonome a un fichier projet, ouvrez le fichier 
projet, puis choisissez File I Add to Project (voir la section "Ajout d'une 
ressource" du chapitre 14). 

Lorsque vous choisissez le format Binary, Resource Workshop affiche la 
boite de dialogue New File Resource afin de nommer votre fichier police et 
de specifier le projet dans lequel il sera reference. Lorsque le type de 
ressource selectionne est une police, la boite de saisie File Name indique 
*.FNT. 

1. Entrez un nom pour votre fichier .FNT dans la boite de saisie File Name. 
Assurez-vous que le nom de votre projet apparait dans la boite liste 
intitulee "A reference to the resource...". Pour changer le repertoire de 
stockage du fichier, definissez le chemin en double-cliquant sur les 
polices appropriees dans la boite liste Directories. Le chemin choisi est 
affiche dans la boite de saisie Path. 

2. Lorsque vous avez effectue vos selections, cliquez sur OK. Resource 
Workshop affiche une boite de dialogue vous specifiant que le fichier 
nomme n'existe pas, et vous demandant si vous voulez creer le fichier. 
Cliquez sur Yes. 

3. Lorsque vous quittez la boite de dialogue New File Resource, Resource 
Workshop lance l'editeur Paint. 

Vous pouvez aussi choisir un nom de fichier dans la boite liste Files. Dans ce 
cas, vous ecraserez le fichier existant. Par precaution, Resource Workshop 
vous demande si vous voulez ecraser le fichier. 



Fichier projet police 



Si vous choisissez File I New Project et selectionnez .FNT dans la boite de 
dialogue New Project, vous creez automatiquement un fichier police 
autonome. Resource Workshop lance immediatement l'editeur Paint. 
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Edition d'une ressource police 



Lorsque vous ouvrez une nouvelle ressource police ou une ressource police 
existante dans l'editeur Paint, les caracteres ou les images dans la police en 
cours d'edition sont affiches dans une "liste" situee sur la bordure droite de 
la fenetre. 

Lorsque vous lancez l'editeur Paint, il charge automatiquement la premiere 
image police de la liste. Pour charger une autre image afin de l'editer, 
cliquez-la dans la bordure droite de l'editeur Paint. Utilisez ensuite les outils 
de l'editeur Paint pour effectuer les changements souhaites. 



Definition et ajout 
de caracteres pour 
une police 



Si vous creez une nouvelle ressource police, elle ne comprend qu'une image 
de 8x8 pixels. Generalement, vous voudrez plusieurs images dans votre 
ressource police. Vous pouvez aussi vouloir specifier une taille d'image 
differente. Pour specifier plusieurs images dans une ressource police et pour 
en modifier la taille, utilisez l'option Font I Font Size. 



Definition de la 
taille de police 



Voir la section 

"Creation de polices 

proportionnelles" de ce 

chapitre pour plus 

d'informations sur les 

polices de largeur 

variable. 



Pour definir la taille de police, suivez les etapes ci-dessous : 

1. Choisissez Font I Font Size pour afficher la boite de dialogue Font Size 
Information. 

2. Effectuez votre choix parmi les options de taille decrites dans le 
tableau 22.1. Les images d'une ressource police peuvent etre de largeur 
variable ou de largeur fixe. 

■ Les polices contenant des lettres ou des images variables en largeur 
sont appelees polices de largeur variable ou polices proportionnelles. Par 
exemple, dans une police proportionnelle, la lettre "m" est nettement 
plus large que la lettre "i". Les livres (y compris cet ouvrage) sont pres- 
que toujours imprimes avec une police proportionnelle. 

■ Les polices dont les caracteres ou les images sont toutes de meme 
largeur sont appelees polices de largeur fixe ou polices a espacement 
fixe. La plupart des machines a ecrire utilisent des polices a espacement 
fixe. 

Les caracteres de largeur variable occupent generalement moins de place et 
sont plus agreables a regarder que les caracteres d'une police a espacement 
fixe. Comparez les deux lignes suivantes, et plus particulierement 
l'espacement autour de la lettre "i". 
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Minimum (police proportionnelle) 

Minimum (police a espacement fixe) 



Tableau 22.1 

Options de taille de 

police 



Option Description 

Width Si vous voulez que toutes les images aient la meme largeur (largeur fixe), 

tapez la largeur en pixels. Si vous voulez des largeurs differentes (largeur 
variable), tapez (zero) et specifiez une largeur maximale. 

Height Tapez la hauteur, en pixels, des images police. 

Average Width Resource Workshop calcule une largeur moyenne d'image police, si vous 

avez specifie pour Width (police proportionnelle). Pour une police a 
espacement fixe, I'option Average Width est identique a I'option Width. 

La largeur moyenne est calculee lorsque vous ouvrez cette boite de dialogue. 
Vous ne verrez pas la modification de cette valeur si vous tapez d'autres 
changements dans cette boite de dialogue. 

Maximum Width Pour les polices proportionnelles, specifiez la largeur maximale en pixels. 

Cette option n'est disponible que si vous avez tape en regard de Width. 
Stretch Current Activez cette option si vous voulez augmenter ou diminuer la hauteur ou la 
Chars largeur d'images existantes, sur la base des modifications de largeur et de 

hauteur tapees dans cette boite de dialogue. Les caracteres sont alors 

deformes proportionnellement. 



Definition du 
nombre de 
caracteres 



La boite de dialogue Font Size Information vous permet aussi de choisir le 
nombre d'images a inclure dans votre ressource police. La premiere et la 
derniere valeur des options Character (voir le tableau 22.2) determinent le 
nombre de caracteres que la ressource police contiendra. 

Si le nombre est trop bas, vous pouvez changer les valeurs pour augmenter 
le nombre de caracteres disponibles. 



Projection du jeu 
de caracteres 



Choisissez une plage de codes decimaux pour etablir une correspondance 
entre vos images police et le jeu de caracteres ANSI. Par exemple, pour 
etablir une correspondance entre une image police et le caractere a, specifiez 
le code decimal 97. II n'est pas necessaire que l'image elle-meme soit le 
caractere a, a moins que vous ne le souhaitiez. Ainsi, si l'image de bombe 
presentee plus haut est projetee sur a dans une police donnee, la seconde 
image police sera projetee sur le caractere b, code decimal 98. 
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Les valeurs ANSI avec lesquelles vous etablissez une correspondance avec 
un ensemble d'images bitmap sont arbitraires, mais doivent etre comprises 
entre et 255. Ces valeurs ANSI deviennent importantes lorsque vous 
chargez la police dans votre programme et affichez les images bitmap, car 
vous utilisez la valeur ANSI associee a l'image bitmap pour l'afficher, de 
meme que vous utilisez une valeur ANSI pour afficher un caractere. 

Utilisez les options Character suivantes pour projeter le jeu de caracteres ou 
d'images dans votre ressource police : 



Tableau 22.2 
Options Character 



Option 



Description 



First 



Last 



Default 



Break 



Tapez un code decimal ANSI pour definir la premiere image de votre police. 
Par exemple, si vous souhaitez que la premiere image corresponde a a, 
tapez 97. 

Tapez un code decimal ANSI pour definir la derniere image de votre police. 
Par exemple, si vous voulez que la derniere image corresponde a z, tapez 

122. 

Tapez un code decimal ANSI pour definir l'image police par defaut affichee 
lorsque vous editez cette ressource police. La valeur par defaut doit 
appartenir a la plage de caractere definie par les valeurs First et Last. Par 
exemple, si vous avez tape 97 pour la valeur First et 1 22 pour Last, vous ne 
pouvez pas taper 88 pour Default. 

Tapez un code decimal ANSI pour definir un caractere de separation pour 
votre ressource police. Par exemple, le caractere d'espacement est utilise 
pour completer des lignes justifies. La valeur Break doit etre comprise entre 
les valeurs First et Last. 



Creation de polices 
proportionnelles 



Pour creer des caracteres ou des images de largeur variable dans votre 
ressource police : 

1. Choisissez Font I Font Size. 

2. Face a Width, tapez (zero). 

3. Face a Maximum Width, tapez la largeur maximale (en pixels) pour tous 
les caracteres ou images de votre ressource police. 



Definition de la 
largeur d'un 
caractere ou d'une 
image 



Apres le choix de la valeur dans la boite de dialogue Font Size 
Information, vous pouvez choisir la largeur d'une image ou d'un caractere 
particulier au moyen de la commande Font I Character. 
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Utilisez I'option Stretch 

Current Chars pour 

deformer I'image par 

rapport a ses 

proportions normales. 



Par exemple, utilisez I'option Font I Font Size pour definir les tailles 
suivantes pour votre ressource police, qui contient des images bitmap : 

Largeur 

Hauteur 32 

Largeur maximale 32 

En fonction de ces tailles, toutes les images auront 32 pixels en hauteur et 
une largeur maximale de 32 pixels. Lors de l'edition d'une image 
particuliere, vous pouvez utiliser I'option Font I Character Width pour 
definir la largeur de cette image. 

Choisissez Font I Character Width pour afficher la boite de dialogue 
Character Width. 

A cote de la rubrique Width, tapez une valeur inferieure ou egale a la 
largeur maximale. En outre, vous pouvez activer I'option Stretch Current 
Chars, si vous voulez que I'image existante soit dilatee ou contracted, sur la 
base de la modification de largeur tapee dans cette boite de dialogue. 



Definition d'un Chaque ressource police comprend un en-tete qui contient des informations 

en-tete pour une generales concernant la police, comme le nom de la police et les 

ressource police informations de copyright. Si vous definissez une ressource police 

comprenant des caracteres alphanumeriques, l'en-tete definit le style et la 

taille de tous les caracteres de la police. 

Pour definir l'en-tete d'une police, 

1. Affichez la police dans l'editeur Paint en double-cliquant sur le nom de 
police dans la fenetre projet, ou en utilisant Resource I New pour creer 
une nouvelle ressource police. 

2. Choisissez Font I Header pour specifier les informations d'en-tete. Vous 
obtenez la boite de dialogue Font Header Information. 
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3. Definissez l'en-tete de vos polices personnalisees. Le tableau suivant 
decrit les choix possibles : 



Tableau 22.3 
Options d'en-tete 



Option 



Description 



Face Name 
Device 

Copyright 
Font version 



Attributes 

- Italic 

- Underline 

- Strikeout 

- Variable Pitch 

- Weight 

- Family 



Char set 



Sizes 

- Horz Res 

- Vert Res 

- Points 



Internal Leading 
External Leading 
Ascent 



Tapez le nom a affecter a votre police. 

Tapez un nom de peripherique pour votre police afin d'informer vos 
programmes qu'elle ne peut etre utilisee que sur un peripherique particulier. 

Tapez les informations de copyright de votre police personnalisee. 

La version de police 2.00 est supportee dans tous les cas. Vous pouvez 
utiliser la version 3.0 si vous creez une application Windows 3.x qui 
fonctionnera dans un environnement en mode protege (mode standard ou 
mode 386 etendu) sur un processeur 80386 (ou superieur). 

La police contient des caracteres en italique. 

La police contient des caracteres soulignes. 

La police contient des caracteres biffes. 

La police est une police proportionnelle. 

La police est normale (400) ou en caractere gras (700). 

Decrit la famille de police. Les valeurs acceptables sont : 

Indifferent 3 Modern 

1 Roman 4 Script 

2 Swiss 5 Decorative 

Definit le jeu de caracteres. La valeur est comprise entre et 255. 0, 2 et 255 
ont les significations predefines suivantes : 

ANSI, le jeu de caracteres Windows par defaut. 

2 Symbole, pour les formules mathematiques et scientifiques. 

255 OEM un jeu de caracteres specifique a la machine. 

Nombre horizontal de pixels par pouce logique sur votre affichage video. 

Nombre vertical de pixels par pouce logique sur votre affichage video. 

Taille du caractere. Un point correspond a 1/72 de pouce. Un caractere est 
mesure du haut de I'ascendante au bas de la descendante. La valeur entree 
a ce niveau ne doit pas inclure d'espace pour les signes diacritiques. 

Espace en pixels reserve aux signes diacritiques. 

Espace supplemental en pixels entre les lignes de caracteres. 

La hauteur en pixels du caractere au-dessus de la ligne de base. 
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Modification de la Lorsque vous editez une ressource police dans l'editeur Paint, le menu Font 

taille et des propose trois commandes pour modifier les images police. 

attributs 

■ Header definit les informations d'en-tete de votre ressource police, y 

compris la version de police, son nom, les informations de copyright, etc. 
Pour plus d'informations, voir la section precedente. 

■ Font Size definit le jeu de caracteres de cette police, ainsi que la largeur et 
la hauteur de chaque caractere. Pour plus d'informations, voir la section 
"Definition et ajout de caracteres pour une police" plus haut dans ce 
chapitre. 

■ Character Width specifie la largeur d'une image particuliere, dans une 
ressource police de largeur variable. Cette commande ne sera disponible 
que si vous avez deja defini une police proportionnelle avec Font I Font 
Size. Pour plus d'informations, voir la section "Creation de polices 
proportionnelles" plus haut dans ce chapitre. 

Utilisation de vos polices dans vos applications 

Avec d'autres ressources, vous utilisez Resource Workshop ou le 
compilateur de ressources Borland (BRC), pour lier vos ressources a vos 
fichiers executables. Cependant, les polices ne peuvent etre liees a un fichier 
executable. Vous devrez alors creer une DLL (ressource uniquement) 
speciale avec l'extension .FON, puis la charger dans votre programme au 
moyen de la fonction Windows AddFontResource. 

Vous pouvez creer un fichier .FON en utilisant soit Turbo Pascal, soit C++ et 
Turbo Assembler. 
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Creation des ressources definies 
par I'utilisateur 



Reportez-vous a 

I'ouvrage 

"Programming 

Windows" de Charles 

Petzold, pour plus 

d'informations sur les 

metafichiers. 



Outre les types de ressources decrits dans les chapitres precedents, vous 
pouvez aussi definir vos propres ressources. Apres avoir cree un nouveau 
type de ressource, vous pouvez ajouter a votre projet des ressources definies 
par I'utilisateur de ce type. 

Vous pouvez definir vos propres types de ressources pour y stacker des 
donnees qui ne s'adaptent a aucun type de ressource standard. Par exemple, 
si vous voulez creer une ressource chaine de caracteres plus longue que la 
limite STRINGTABLE de 255 caracteres, vous pouvez definir votre propre 
type de ressource, et y stacker vos chaines de caracteres. 

Dans votre projet, vous pouvez aussi inclure des metafichiers, en tant que 
ressources definies par I'utilisateur. Un metafichier est un type de graphique 
par points (en format source, c'est une collection d'appels a l'interface 
graphique GDI). Ce type de fichier est plus facile a redimensionner et plus 
independant des peripheriques que les ressources bitmap standard. II 
occupe aussi moins de place de stockage. 

Lorsque vous definissez une nouvelle ressource, vous pouvez stacker les 
donnees en tant que partie de la definition de la ressource, dans un projet 
fichier, ou en tant que fichier distinct. Comme avec toute ressource, 
Resource Workshop peut compiler les donnees et les lier a votre fichier 
executable pour que votre application puisse en disposer pendant 
l'execution. 

Vous pouvez aussi utiliser le type de ressource RCDATA pour ajouter des 
donnees a votre application. Voir la section "Utilisation du type de ressource 
RCDATA" a la fin de ce chapitre pour plus d'informations. 
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Travailler avec des ressources definies par l'utilisateur implique cinq etapes 
principales : 

1. Creer un type de ressource definie par l'utilisateur. 

2. Ajouter une ressource definie par l'utilisateur a votre projet. 

3. Editer la ressource definie par l'utilisateur. 

4. Tester la ressource definie par l'utilisateur. 

5. Enregistrer la ressource definie par l'utilisateur. 



Creation d'un type de ressource 



Lechapitre Udecritla 

procedure d'ouverture 

d'un projet. 



Si vous utilisez un 

identificateur 

numerique, il doit etre 

superieur a 255, car 

Windows reserve les 

valeurs 1 a 255 aux 

ressources standard. 



Avant d'ajouter une ressource definie par l'utilisateur a votre projet, vous 
devez d'abord lui creer un type, de la facon suivante : 

1. Ouvrez un projet. 

2. Choisissez Resource I New. 

3. Dans la boite de dialogue New Resource, cliquez sur le bouton New 
Type. Resource Workshop affiche la boite de dialogue New Resource 
Type. 

4. Dans la boite de dialogue New Resource Type, tapez un nom pour le 
type de ressource que vous creez. Par exemple, si vous creez une 
ressource devant contenir un grand bloc de texte, vous pouvez nommer 
votre nouveau type de ressource TEXT. Appuyez sur Entree 

5. Lorsque le systeme vous demande si vous voulez creer un identificateur 
pour le nouveau type de ressource, cliquez sur Yes. Entrez une valeur 
dans la boite de dialogue New Identifier. Cette valeur est l'identificateur 
que Windows et votre programme associeront a ce type d'identificateur. 

Une fois que vous avez defini un nouveau type de ressource, et lorsque 
vous creez une nouvelle ressource, vous verrez ce type enumere dans la 
boite de dialogue New Resource, avec tous les types de ressources standard 
(ACCELERATOR, BITMAP, DIALOG, etc.) . 
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Ajout d'une ressource definie par I'utilisateur 



Apres avoir cree un type de ressource, vous pouvez ajouter a votre projet 
une ressource de ce type, de la facon suivante : 

Le chapitre 14 decrit la 1. Ouvrez un projet. 

U d'unnmist ^~ Choisissez Resource I New. Resource Workshop affiche la boite de 
dialogue New Resource. 

3. Dans la boite de dialogue New Resource, selectionnez votre type de 
ressource definie par I'utilisateur. Sous la rubrique "Place resource in", 
selectionnez le fichier projet (probablement le fichier actif) ou vous 
voulez stacker la ressource. 



d'un projet. 



4. Lorsque vous cliquez sur OK dans la boite de dialogue New Resource, 
Resource Workshop ouvre l'editeur de texte, avec une definition vierge, 
pour votre ressource. Par exemple, si vous ajoutez une ressource appelee 
TEXT, vous verrez le code suivant dans l'editeur de texte : 

TEXT_1 TEXT 
( 

) 

La section suivante decrit la procedure d'edition d'une ressource definie par 
I'utilisateur. 



Edition d'une ressource definie par I'utilisateur 



Le chapitre 14 decrit la Pour editer une ressource definie par I'utilisateur, un projet doit etre ouvert. 
procedure d'ouverture Vous pouvez creer la ressource (voir la section precedente) ou encore ouvrir 
un pr0|e ' une ressource existante, dans la fenetre projet. 

Le nom de ressource est identifie dans la fenetre projet par son type de 
ressource definie par I'utilisateur, comme toute autre ressource de type 
predefini. Par exemple, si vous creez un type de ressource TEXT et une 
ressource TEXT, vous verrez l'entree ressource TEXT dans la fenetre projet. 

Pour ouvrir l'editeur, 

■ Double-cliquez sur le nom de la ressource a editer. 

■ Selectionnez le nom de la ressource, puis choisissez Resource I Edit ou 
Resource I Edit As Text (les deux commandes lancent l'editeur de texte). 
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Une fois que vous avez appele la ressource dans l'editeur de texte, vous 
pouvez lui ajouter des donnees, ou editer les donnees qu'elle contient. Void 
un exemple de ce qui apparait lorsque vous ajoutez a votre projet une 
nouvelle ressource definie par l'utilisateur, du type RESTYPE : 

RESTYPE_1 RESTYPE 
BEGIN 

[definitions de donnees] 
END 

La premiere ligne indique le nom et le type de ressource. Pour une nouvelle 
ressource, Resource Workshop construit un nom par defaut : il adjoint au 
type de ressource un soulignement et un nombre entier. Par exemple, la 
premiere ressource RESTYPE ajoutee a votre projet devient RESTYPE_1, la 
deuxieme devient RESTYPE_2, etc. 

Pour ajouter des donnees a votre ressource, executez une des procedures 
suivantes : 

■ Utilisez l'editeur de texte pour taper des donnees entre les parentheses. 

■ Stockez les donnees dans un fichier distinct, et ajoutez le nom de fichier a 
la fin de la premiere ligne du script ressource, comme suit : 

RESTYPE_1 RESTYPE MYRES.FIL 

Vous devez aussi effacer les lignes contenant les instructions BEGIN et 
END. 

■ Utilisez la commande Add to Project, comme specifie dans la section 
suivante. 

Apres avoir effectue les modifications dans le script ressource, vous devez 
recompiler la ressource pour les enregistrer. Si vous quittez sans recompiler, 
les modifications seront perdues. 



Integration des 
donnees 

ressources dans le 
fichier projet 



Comme specifie dans la section precedents, vous pouvez ajouter des 
donnees a votre ressource en stockant les donnees dans un fichier distinct. 
L'inconvenient de cette approche est le suivant : si un incident intervient sur 
le fichier, les donnees seront perdues. Une autre option consiste a integrer 
les donnees externes dans le script du fichier projet. 
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Vous pouvez aussi 

entrer le nom de fichier 

et le chemin d'acces 

complet dans la boite 

de saisie File Name. 



Comment entrer 
des donnees dans 
le script ressource 



Par exemple, si vous disposez du type de ressource definie par l'utilisateur 
TEXT et du fichier donnees ressources MY_RES.TXT, vous pouvez integrer 
les donnees dans le projet en suivant les etapes ci-dessous : 

1. Choisissez File I Add to Project. Resource Workshop affiche la boite de 
dialogue Add File to Project. 

2. Selectionnez "user Resource data" dans la boite liste File Type. 

3. Changez la boite de saisie File Name pour indiquer * . TXT. 

4. Changez le repertoire (si necessaire) jusqu'a ce que MY_RES.TXT soit 
visible dans la liste File. Double-cliquez sur MY_RES.TXT. 

5. Resource Workshop affiche la boite de dialogue Custom Resource Type. 
Double-cliquez sur l'entree pour le type de ressource TEXT. Une 
nouvelle ressource TEXT apparait dans la fenetre projet. 

Si vous selectionnez la nouvelle ressource et choisissez Resource I Edit 
(ou Edit as Text, effet identique), vous constaterez que les ressources ont 
ete converties au format hexadecimal. Pour cette raison, il est conseille de 
conserver le fichier de donnees externe au cas ou vous voudriez editor le 
script ressource plus tard. 

Lorsque vous utilisez l'editeur de texte, les touches Tab, Suppr, Debut, Fin, 
PgPrec, PgSuiv et Retour arriere operent comme d'habitude. Cependant, 
n' utilisez pas cet editeur pour un travail de formatage important, car 
Resource Workshop est susceptible de reorganiser le texte lorsqu'il compile 
ou decompile cette ressource. 

Void quelques directives pour specifier les donnees entre les parametres 
BEGIN et END : 

Les donnees peuvent inclure toute combinaison de valeurs numeriques et 
de chaines. 

■ Vous pouvez utiliser une notation hexadecimale, octale ou decimale pour 
representor les valeurs numeriques. 

• Utilisez Ox (un zero suivi de la lettre x) ou $ (un signe dollar) comme 
caracteres de tote dans une notation hexadecimale. Cette notation 
n'accepte que les valeurs 16 bits. Si vous voulez utiliser un nombre 
impair de valeurs hexadecimales, utilisez le type de donnees hexstring 
(decrit ci-apres). 

• Utilisez Oo (un zero suivi de la lettre o) ou simplement (zero) comme 
caracteres de tote en notation octale. 
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■ Vous pouvez aussi representer les valeurs hexadecimales en utilisant un 
hexstring (chaine hexadecimale) de valeurs hexadecimales encadrees par 
des apostrophes. Le compilateur ignore les espaces inseres pour faciliter la 
lecture des codes hexadecimaux. 

Par exemple, vous pourriez representer les valeurs ASCII des caracteres 
dumotstring sous la forme '73 74 72 69 6E 67' et lenumero 
hexadecimal 06E07A avec '0 6E07A'. 

■ Si vous incluez des chaines de texte dans votre ressource, encadrez les 
chaines par des guillemets, comme ceci : "string". 

Les chaines ne sont pas automatiquement terminees par un zero. Pour 
cela, tapez \ (barre oblique inverse, zero), a la fin de la chaine. 

Par exemple, votre script ressource avec des donnees ajoutees pourrait avoir 
l'aspect suivant : 

RESTYPE_1 RESTYPE 
BEGIN 

"This is a string" . 

OxFFAA 0o7076 01077 

"54 68 69 73 20 69 73 0D 0A 73 6F 6D 65 20 73 61" 

"6D 70 6C 65 0D 64 61 74 61 2E" 
END 



Gestion des 
donnees stockees 
dans un fichier 
distinct 



Si les donnees sont stockees dans un fichier distinct, vous devez utiliser un 
editeur externe pour editer le fichier. Pour ajouter une reference au fichier 
de donnees dans le script ressource : 

■ Sur la premiere ligne du script, apres le nom du type de ressource, entrez 
le nom du chemin d'acces complet du fichier. 

■ Effacez les instructions BEGIN et END. 

Le script ressource qui suit (pour la ressource RESTYPE_1), indique que les 
donnees sont stockees dans le fichier C:\RW\MYDATA.TXT : 

RESTYPE_1 RESTYPE c:\rw\mydata.txt 
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Utilisation du type de ressource RCDATA 



Les ressources Vous pouvez utiliser le type de ressource predef ini RCDATA pour ajouter 

RCDATA ont ete une ressource donnees a votre application. II fonctionne de la meme facon 

" ,c " s . es , f" s qu'un type de ressource definie par l'utilisateur. La difference principale 
Resource Workshop ,,, ,,, ,■ , 

pour des raisons de reside dans la capacite d adressage : vous pouvez pref erer de nombreux 

compatibilite. types de ressources definies par l'utilisateur plutot qu'un seul type 

RCDATA. 

Si vous utilisez une ressource RCDATA, ajoutez-la au projet en choisissant 
File I New, et en ajoutant une nouvelle ressource du type RCDATA. Vous 
apercevez une definition RCDATA vierge dans l'editeur de texte. Vous 
pouvez taper les donnees entre les parametres BEGIN et END. Pour taper 
les donnees, utilisez les regies decrites pour les ressources definies par 
l'utilisateur. 
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A 



Messages d'erreur 



Cette annexe repertorie les messages d'erreur qui peuvent etre generes par 
le compilateur, l'utilitaire MAKE, le bibliothecaire (TLIB), l'editeur de liens 
(TLINK) et le compilateur d'aide pour Windows de Borland C++. Elle 
comporte egalement des messages d'erreur generes lors de l'execution de 
vos programmes ou en temps reel. 

Les messages sont tries dans l'ordre alphabetique en anglais (les messages 
debutant par un symbole precedent ceux debutant par un chiffre, puis ceux 
debutant par une lettre). Les messages debutant par un symbole sont tries 
selon l'ordre alphabetique du premier mot suivant ce symbole. Par exemple, 
le message suivant peut s'afficher si vous avez mal declare la fonction 
majonct : 

ma_fonct must be declared with no parameters 

Reportez-vous a "must" dans la liste pour verifier ce message. 



Types de messages 



II existe trois types de messages, a savoir, les erreurs fatales, les erreurs 
simples et les mises en garde. 



Erreurs fatales Une erreur fatale peut etre generee par le compilateur, l'editeur de liens ou 

l'utilitaire MAKE. Elle provoque l'interruption immediate de la compilation. 
Vous devez imperativement resoudre le probleme avant toute reprise de la 
compilation. 

En cas d'erreur fatale generee par le compilateur ou l'utilitaire MAKE, 
aucun fichier executable .EXE n'est cree. En cas d'erreur fatale generee par 
l'editeur de liens, tout fichier .EXE que l'editeur a pu cree est supprime 
avant la fin du traitement par l'editeur. 
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Erreurs 



Une erreur peut etre generee par le compilateur, l'editeur de liens, 
l'utilitaire MAKE ou le bibliothecaire. Elle peut egalement etre generee a 
l'execution de l'un de vos programmes. 

Une erreur generee par le compilateur indique une erreur de syntaxe dans le 
programme, une erreur dans la ligne de commande ou une erreur d'acces a 
un disque ou a la memoire. Ce type d'erreur ne provoque pas l'interruption 
de la compilation. Le compilateur execute jusqu'au bout la phase de 
compilation en cours, interrompt la compilation et affiche les erreurs 
detectees. Le compilateur essaye de detecter toutes les erreurs possibles 
dans le code source au cours de chaque phase de compilation (traitement 
par le preprocesseur, analyse syntaxique, optimisation et generation du 
code). 

Une erreur generee par l'editeur de liens n'entraine pas la suppression de 
fichiers .EXE ou .MAP par ce meme editeur. II n'est pas conseille d'executer 
un fichier .EXE dont l'edition de liens a comporte des erreurs. Une erreur 
generee par l'editeur de liens est traitee comme une erreur fatale si vous 
compilez a partir de l'environnement EDI (Environnement de 
developpement integre). 

L'utilitaire MAKE genere une erreur en cas d'inexactitude syntaxique ou 
semantique dans le fichier MAKE source. Corrigez ce type d'erreur 
directement dans le fichier. 

Une erreur d'execution est en general due a une erreur logique dans le code 
d'un programme. Dans ce cas, corrigez l'erreur dans le code source et 
recompilez le programme pour verifier l'efficacite de cette modification. 



Mises en garde Un message de mise en garde peut etre genere par le compilateur, l'editeur 

de liens ou le bibliothecaire. Bien que la generation d'un tel message 
n'empeche pas la fin de la compilation d'un programme, il indique des 
conditions peu fiables meme si la condition a l'origine du message est 
justifiee dans le langage. Le compilateur genere egalement des messages de 
mise en garde si vous utilisez des compilations specifiques a votre machine 
dans vos fichiers source. 
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Messages du compilateur d'aide 



Le compilateur d'aide affiche des messages lorsqu'il detecte des erreurs ou 
des mises en garde au cours de la creation du fichier ressource du systeme 
d'aide. Un message genere lors du traitement du fichier projet est precede 
de la lettre P et suivi d'un code d'erreur. Un message genere lors du 
traitement d'un ou de plusieurs fichier(s) d'ecran d'aide RTF est precede de 
la lettre R et suivi d'un code d'erreur. 

Le compilateur d'aide affiche le numero d'ecran d'aide et/ou le nom du 
fichier contenant l'erreur chaque fois que cela est possible. Si les ecrans 
d'aide ont ete numerates, le numero affiche avec un message d'erreur 
designe la position sequentielle de cet ecran dans le fichier RTF (premier, 
second, etc.). Ce numero peut correspondre au numero de page indique par 
votre traitement de texte. Dans les fichiers sources du systeme d'aide, les 
ecrans sont separes par des ruptures de page forcees bien que le systeme 
d'aide ne soit pas structure en pages a proprement parler. 

Un message debutant par le mot "Error" indique une erreur fatale. Le 
message d'erreur s'affiche systematiquement et aucun fichier d'aide 
utilisable n'est genere. Un message debutant par le mot "Warning" indique 
une erreur de nature moins grave. Un fichier ressource d'aide est genere et 
peut etre charge sous Windows. Ce fichier peut cependant ne pas 
fonctionner normalement. 



Listes de messages 



Pour chaque message sont indiques dans l'ordre, le type de message, le nom 
du fichier source et le numero de ligne ou l'erreur a ete detectee et le texte 
du message. 

Certains messages sont precedes d'un symbole (comme une variable, un 
nom de fichier ou un module) extrait de votre programme. Un symbole 
figure en italique dans la description d'un message. Par definition, un 
symbole peut varier dans un message. 

Remarquez que le compilateur genere les messages au fur et a mesure qu'il 
les detecte. Comme les langages C et C++ n'imposent aucune restriction sur 
la position d'une instruction dans une ligne de texte, la veritable origine de 
l'erreur peut en fait se situer une ou plusieurs lignes avant ou apres le 
numero de ligne indique dans le message d'erreur. 
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Description des messages 



')' missing in macro invocation Erreurde MAKE 

Parenthese gauche manquante dans I'appel d'une macro. 

( expected Erreur du compilateur 

Parenthese gauche manquante. Ajoutez-la au debut d'une liste de parametres. 

) expected Erreur du compilateur 

Paranthese droite manquante. Ajoutez-la a la fin d'une liste de parametres. 

, expected Erreur du compilateur 

Virgule manquante. Les elements d'une liste de declaratons, d'initialisations ou de parametres doivent etre separes par une 
virgule. 

: expected after private/protected/public Erreur du compilateur 

Lorsque les mots reserves private/protected/public sont utilises pour debuter une section de classe, ils doivent 
imperativement etre suivis d'un signe deux-points (:). 

< expected Erreur du compilateur 

Le mot cle template doit etre suivi du signe inferieur (<). Dans une declaration de template, les parametres formels de 
template doivent figurer entre les signes < et > immediatement apres le mot cle template. 

> expected Erreur du compilateur 

Signe ">" manquant dans une instruction de nouveau transtypage (par exemple, dynamic_cast). 

@ seen, expected a response-files name Erreur du bibliothecaire 

Aucun fichier de recherche n'est specifie immediatement apres @@. 

{ expected Erreur du compilateur 

Accolade gauche ({) manquante au debut d'un bloc ou d'une initialisation. 

} expected Erreur du compilateur 

Accolade droite (}) manquante a la fin d'un bloc ou d'une initialisation. 

16-bit segments not supported in module module Erreurde I'editeurde liens 

Les segments 1 6 bits ne sont pas geres dans les applications 32 bits. Verifiez que vous n'avez pas compile par erreur une 
application 32 bits a I'aide du compilateur 16 bits. 

286/287 instructions not enabled Erreur du compilateur 

Specifiez I'option de compilateur -2 sur la ligne de commande ou selectionnez les options 80286 a partir de la boite de 
dialogue Options|Compiler|Code Generation|Advanced Code Generation pour activer les codes operation 286/287. 
Remarquez que le code obtenu ne peut etre execute sur une machine a microprocesseur 8086 et 8088. 

32-bit record encountered Erreur de I'editeur de liens 

Un fichier objet contenant des enregistrements 32 bits 80386 a ete detecte alors que I'option 12 n'a pas ete specifier. 

Abnormal program termination Erreur d'execution 

Le programme a fait appel a abort car il ne disposait plus de memoire suffisante pour s'executer. Ce message peut etre 
genere en cas de surecritures en memoire. 
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Access can only be changed to public or protected Erreurdu compilateur 

Un membre d'une classe de base peut etre rendu accessible en mode public ou protected a partir d'une classe derivee. II 
est impossible de lui attribuer des droits d'acces private. 

Added file nomjichier does not begin correctly, ignored Mise en garde du bibliothecaire 

Le fichier indique ne correspond pas a un module objet et n'est done ajouter a la bibliotheque. La bibliotheque est quand 
meme creee. 

Address of overloaded function fonction doesn't match type Erreur du compilateur 

Une variable ou un parametre est affecte ou initialise avec I'adresse d'une fonction surcharged. Le type de la variable ou du 
parametre ne correspond a aucun des types des fonctions surchargees dont le nom est specifie. 

module already in LIB, not changed! Mise en garde du bibliothecaire 

Vous avez essaye d'ajouter un objet a une bibliotheque (operation +) mais un objet portant le meme nom existe deja dans 
cette bibliotheque. Pour mettre a jour le module, utilisez Taction +-. La bibliotheque n'a pas ete modifiee. 

Ambiguity between fonction land tonction2 Erreur du compilateur 

Les fonctions surchargees indiquees peuvent toutes deux etre utilisees avec les parametres fournis. Cette ambiguite n'est 
pas autorisee. 

Ambiguous member name nom Erreur du compilateur 

Un membre de structure en assembleur en ligne doit etre designe par un seul nom. S'il est defini dans plusieurs structures, 
les definitions correspondantes doivent indiquer le meme type et le meme decalage au sein de ces structures. Le nom de 
membre est dans ce cas ambigu. Utilisez de preference la syntaxe (struct xxx) .yyy. 

Ambiguous Override of Virtual Base Member fonction 1:fonction2 Erreurdu compilateur 

Une fonction virtuelle dans une classe de base virtuelle a ete supplantee par deux fonctions differentes ou plus selon 
differents chemins de la hierarchie d'heritage. 

Ambiguous operators need parentheses Mise en garde du compilateur 

Ce message s'affiche lorsque deux operateurs de decalage, relationnels ou booleens bit a bit sont utilises sans parentheses. 
Un operateur d'addition ou de soustraction specifie sans parentheses avec un operateur de decalage genere egalement ce 
message. Veillez a respecter la priorite de ces operateurs. 

Ambiguous override of virtual base member fonction_base:fontion_derivee Erreurdu compilateur 

Ce message est genere lorsqu'une fonction virtuelle definie dans une classe de base virtuelle est supplantee par differentes 
fonctions ayant deux classes derivees dans la meme hierarchie d'heritage. Par exemple : 

struct VB 
{ 

virtual f ( ) ; 



struct A: virtual VB 
{ 

virtual f ( ) ; 



struct B: virtual VB 
virtual f ( ) ; 
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}; 

struct D:A,B 

{ 

} //erreurs ICI 

Le code ci-dessus est marque avec les messages d'erreurs suivants : 

Error: Ambiguous override of virtual base member VB : : f ( ) : A: : f () 

Error: Ambiguous override of virtual base member VB: : f () :B: : f () 

Application load & execute error 0001 Erreurdu compilateur 

Application load & execute error FFEO Erreurdu compilateur 

Memoire etendue insuffisante pour le chargement de I'outil de ligne de commande en mode protege. 

Array allocated using new may not have an initializer Erreurdu compilateur 

A Initialisation d'un vecteur (tableau) de classes, vous devez imperativement utiliser le constructeur par defaut, c'est-a-dire le 
constructeur sans argument. 

Array bounds missing ] Erreurdu compilateur 

On tableau a ete incorrectement declare dans le fichier source. Ajoutez le crochet droit pour limiter le tableau. 

Array must have at least one element Erreur du compilateur 

En langage ANSI C et C++, un tableau doit comporter au moins un element (il est impossible de definir un objet de taille 
nulle). Une astuce de programmation consiste a declarer un element "tableau" de taille nulle dans une structure, puis 
d'affecter I'espace necessaire a I'aide de malloc. Vous pouvez recourir a cette astuce mais devez imperativement declarer 
I'element "tableau" avec (au moins) un element si vous compilez strictement en mode ANSI. Naturellement, il est toujours 
possible de declarer (a ne pas confondre avec definir) un tableau de taille inconnue. 

Par exemple, 

char ray [ ] ; /* definition avec taille inconnue — illegal */ 

char ray [ ] ; /* definition avec taille nulle — illegal */ 
extern char ray [ ] ; /* declaration avec taille inconnue — ok */ 

Array of references is not allowed Erreurdu compilateur 

II est impossible de declarer un tableau de references dans la mesure ou les pointeurs sur reference ne sont pas autorises et 
que les noms de tableau doivent obligatoirement etre designes par des pointeurs. 

Array size for 'delete' ignored Mise en garde du compilateur 

Selon les dernieres specifications de programmation en langage C++, il n'est plus necessaire de specifier la taille d'un 
tableau pour le supprimer. Pour compiler du code redige selon des specifications plus anciennes, Borland C++ ne tient pas 
compte de cette compilation et genere cet message de mise en garde. 

Array size too large Erreur du compilateur 

La taille du tableau declare depasse la limite de 64 ko. 
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Array variable identificateur is near Mise en garde du compilateur 

Si vous utilisez les options -Ff ou -Fm dans la ligne de commande ou les options EDI Options[Compiler|Advanced Code 
Generation. ..|Far Data Threshold selection pour definir la limite seuil, les variables globales depassant ce seuil sont 
converties en donnees far par le compilateur. Par contre, si la variable est un tableau initialise avec une taille inconnue, sa 
taille totale n'est pas connue lorsque le compilateur doit decider de la convertir en donnees near ou far. Cette variable est 
alors definie comme near. Si la taille totale de la variable depasse le seuil en raison du nombre de variables d'initialisation 
donnees pour le tableau, le compilateur genera ce message. Si le fait que le compilateur definisse la variable en variable near 
pose probleme (par exemple, si I'editeur de liens indique un debordement de groupe du a un nombre trap important de 
donnees globales), vous devez la definir explicitement en tant que variable far en inserant le mot cle far immediatement a 
gauche du nom de la variable dans sa definition. 

Assembler statement too long Erreur du compilateur 

La longueur maximale d'une instruction en assembleur en ligne ne doit pas depasser 480 octets. 

Assigning type to enumeration Mise en garde du compilateur 

Affectation d'une valeur entiere a un type enum. Bien qu'il s'agisse d'une erreur en C++, ce message a valeur de mise en 
garde pour que le programme puisse quand meme s'executer. 

Assignment to this not allowed, use X::operator new instead Erreur du compilateur 

Dans des versions precedentes du C++, la seule fagon de controler I'allocation d'une classe d'objets consistait a affecter le 
parametre this dans un constructeur. Cette methode n'est plus autorisee. Desormais, il est preferable et plus fiable de definir 
une fonction membre operator new. 

Attempt to export non-public symbol symbole Erreur de I'editeur de liens 

Ce message s'affiche en general lorsqu'un fichier .DEF specifie un EXPORT pour un symbole que vous avez soit oublie de 
definir ou que vous avez mal orthographie. 

Attempt to grant or reduce access to identificateur Erreur du compilateur 

Une classe derivee en C++ peut modifier les droits d'acces d'un membre d'une classe de base, mais uniquement en 
retablissant les droits de la classe de base. Elle ne peut pas elargir ou restreindre ces droits d'acces. 

Attempting to return a reference to a local object Erreur du compilateur 

Dans une fonction renvoyant un type reference, vous avez essaye de renvoyer une reference a un objet temporaire (peut-etre 
le resultat d'un constructeur ou d'un appel de fonction). Dans la mesure oil cet objet n'existera plus une fois la fonction 
executee, la reference sera done illegale. 

Attempting to return a reference to local variable identificateur Erreur du compilateur 

Cette fonction C++ renvoie un type reference ou vous essayez de renvoyer une reference a une variable locale automatique. 
Ceci n'est pas autorise car la variable designee n'existera plus a la fin du traitement de la fonction. Vous pouvez renvoyer une 
reference a une variable statique ou globale ou bien modifier la fonction pour qu'elle renvoie une valeur a la place. 

Bad call of intrinsic function Erreur du compilateur 

Vous avez utilise une fonction intrinseque sans fournir de prototype ou le prototype fourni pour une fonction intrinseque ne 
correspondait pas a celui attendu par le compilateur. 

Bad character in parameters Erreur de I'editeur de liens 

Vous avez specifie I'un des caracteres suivants (ou un caractere autre que le caractere de tabulation horizontale, de saut de 
ligne, de retour chariot ou Ctrl+Z) dans la ligne de commande ou un fichier de recherche : 

< = >?[] I 



Annexe A, Messages d'erreur 409 



Bad define directive syntax Erreurdu compilateur 

Une definition de macro debute ou se termine par I'operateur ## ou contient I'operateur* non suivi d'un nom d'argument de 
macro. 

Bad field list in debug information in module module Erreur de I'editeur de liens 

Ce message est generalement du a de mauvaises informations de debogage dans le fichier OBJ. Prenez-en note et 
contactez votre support technique Borland. 

Bad file name nomjichier Erreur de I'editeur de liens 

Le nom de fichier passe en argument a I'editeur de liens est incorrect. 

Bad file name format in include directive Erreurdu compilateur 

Un nom de fichier d'inclusion doit figurer entre guillemets ("FICHIER.H") ou entre parentheses angulaires (<FICHIER.H>). Le 
premier signe ouvrant est manquant au debut du nom de fichier specifie. En cas d'utilisation d'une macro, le texte developpe 
est interprets incorrectement (puisqu'il ne figure ni entre guillemets ni entre parentheses angulaires). 

Bad filename format in include statement Erreur de MAKE 

Un nom de fichier d'inclusion doit figurer entre guillemets ou entre parentheses angulaires. Le premier signe ouvrant est 
manquant au debut du nom de fichier. 

Bad file name format in line directive Erreurdu compilateur 

Un nom de fichier de directives doit figurer entre guillemets ("FICHIER.H") ou entre parentheses angulaires (<FICHIER.H>). 
Le premier signe ouvrant est manquant au debut du nom de fichier specifie. En cas d'utilisation d'une macro, le texte 
developpe est interprete incorrectement (puisqu'il ne figure ni entre guillemets ni entre parentheses angulaires). 

Bad GCD type in GRPDEF, extended dictionary aborted Mise en garde du bibliothecaire 

Bad GRPDEF type encountered, extended dictionary aborted Mise en garde du bibliothecaire 

Le bibliothecaire a detecte une entree incorrecte dans un enregistrement de definition de groupe (GRPDEF) dans un module 
objet lors d'une tentative de creation de dictionnaire etendu. Le bibliothecaire et I'editeur de liens reconnaissent uniquement 
des enregistrements GRPDEF de type indice "index de segment". Le bibliothecaire ne peut pas creer le dictionnaire etendu 
s'il detecte un autre type d'enregistrement. Remarquez qu'un module objet cree a I'aide d'autres outils que ceux fournis par 
Borland peut creer des enregistrements GRPDEF d'autres types. Ce message peut egalement etre genere par un module 
objet defectueux. 

Bad header in input LIB Erreurdu bibliothecaire 

Le bibliothecaire a detecte un en-tete de bibliotheque incorrect dans la bibliotheque a laquelle des modules objets doivent 
etre ajoutes. Recreez la bibliotheque. 

Bad ifdef directive syntax Erreur du compilateur 

Une directive #ifdef doit contenir un seul et unique identificateur. 

Bad LF_POINTER in module module Erreur de I'editeur de liens 

Ce message est generalement du a de mauvaises informations de debogage dans le fichier OBJ. Prenez-en note et 
contactez votre support technique Borland. 

Bad macro output translator Erreur de MAKE 

Erreur de syntaxe de subsitution dans une ou plusieurs macros. Par exemple : 

$ (MODEL :=s) or $ (MODEL:) or $ (MODEL :s) 
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Bad object file nomjichier near file offset decalage Erreurde l'editeur de liens 

L'editeur de liens a derecte un fichier OBJ incorrect. Ce message est generalement du a une erreur du convertisseur. 

Bad object file record in library file nomjichier in module module near module file offset Qxxxxxxxxx 

Bad object file record in module nomjichier near module file offset Qxxxxxxxxx Erreur de l'editeur de liens 

Un fichier objet mal forme a ete detecte. Ce message s'affiche en general lorsqu'il a ete fait appel a un fichier source ou un 
fichier objet qui n'a pas ete completement compile. II s'affiche egalement si la machine a ete reinitialisee lors d'une 
compilation ou si le compilateur n'a pas supprime le fichier objet de sortie lorsque la combinaison Ctrl+Pause a ete actionnee. 

Bad OMF record type type encountered in module module Erreur du bibliothecaire 

Le bibliothecaire a detecte un enregistrement OMF (Object Module Format) incorrect a la lecture du module objet. Les 
enregistrements d'en-tete du module ayant deja ete lus et verifies, ce message indique en general que le module objet a ete 
endommage et qu'il doit etre recree. 

Bad syntax for pure function definition Erreur du compilateur 

Vous devez suffixer "= 0" a la declaration d'une fonction virtuelle pure. Corrigez la definition. 

Bad undef directive syntax Erreur du compilateur 

Une directive #undef doit contenir un seul et unique identificateur. 

Bad undef statement syntax Erreur de MAKE 

Une instruction lundef doit contenir un seul et unique identificateur. 

Bad version number in parameter block Erreur de l'editeur de liens 

Incoherence interne a I'environnement integre. Quittez I'EDI et relancez-le. Cette erreur ne se produit pas dans la version en 
mode autonome. 

Base class classe contains dynamically dispatchable functions Erreur du compilateur 

Dans la version actuelle de Borland C++, les tables DDVT incompatibles avec ('utilisation de I'heritage multiple. Ce message 
s'affiche lorsqu'une classe contenant des fonctions DDVT essaie d'heriter de fonctions DDVT appartenant a plusieurs classes 
parents. 

Base class classe is inaccessible because also in classe Mise en garde du compilateur 

II est impossible d'utiliser une classe a la fois comme classe de base directe et indirecte pour des raisons d'ambiguite des 
membres. Essayez de declarer la classe de base virtuelle aux deux endroits. 

Base class classe is included more than once Erreur du compilateur 

Une classe C++ peut etre derivee a partir d'un nombre indefini de classes de base. Par contre, elle ne peut etre derivee 
directement a partir d'une classe donnee qu'une seule fois. 

Base class classe is initialized more than once Erreur du compilateur 

Dans un constructeur de classe C++, la liste des initialisations apres I'en-tete de constructeur comporte plusieurs fois la 
classe de base classe. 

Base initialization without a class name is now obsolete Erreur du compilateur 

Dans des versions precedentes de C++, Initialisation d'une classe de base consistait a ajouter simplement la liste des 
parametres du constructeur de classe de base apres I'en-tete de constructeur. Dans les versions actuelles, il est 
recommande d'inclure le nom de la classe de base. 
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Cette nouvelle syntaxe clarifie le code et doit etre utilisee en cas de classes de base multiples. 
Ancienne syntaxe : 

derived: :derived(int i) : (i, 10) { ... } 

Nouvelle syntaxe : 

derived :: derived (int i) : base(i, 10) { ... } 

Bit field cannot be static Erreur du compilateur 

Seules les donnees membres de classe C++ ordinaires peuvent etre declarees statiques. Ce type de declaration est 
impossible pour les champs de bits. 

Bit field too large Erreur du compilateur 

Un champ de bits de plus de 32 bits a ete specifie. 

Bit fields must be signed or unsigned int Erreur du compilateur 

En ANSI C, les champs de bits peuvent avoir uniquement les types signed ou unsigned int (les type char ou long, par 
exemple, ne sont pas autorises). 

Bit fields must be signed or unsigned int Mise en garde du compilateur 

En ANSI C, les champs de bits ne peuvent avoir le type signed char ou unsigned char. Si vous ne compilez pas strictement 
en mode ANSI, le compilateur autorise de telles computations mais les signale a I'aide cette mise ne garde. 

Bit fields must contain at least one bit Erreur du compilateur 

S'il est impossible de declarer un champ de bits nomme avec bits ou moins, il est par contre possible de declarer un champ 
de bits non nomme avec bits. Cette convention permet de forcer le champ de bits suivant a s'aligner sur une frontiere de 
type octet (ou de type mot si vous avez selectionne I'alignement correspondant). En C++, les champs de bits (ainsi que les 
enumerations) doivent etre de type entier. 

Bit fields must have integral type Erreur du compilateur 

En C++, les champs de bits (ainsi que les enumerations) doivent etre de type entier. 

Body has already been defined for function fonction Erreur du compilateur 

Un corps de fonction a deja ete specifie pour une fonction definie avec le meme nom et le meme type. Un corps de fonction 
donne ne peut etre specifie qu'une seule fois. 

Both return and return with a value used Mise en garde du compilateur 

La fonction courante comporte des instructions return avec et sans valeurs. Cela est autorise en C mais genere presque 
toujours ce message. Une instruction return a peut-etre ete omise a la fin de la fonction. 

Call of nonfunction Erreur du compilateur 

Le nom appele n'est pas declare en tant que fonction. Verifiez la declaration de la fonction ou I'orthographe de son nom. 

Call to function fonction with no prototype Mise en garde du compilateur 

Le message de mise en garde "Prototypes required" etait active et vous avez appele la fonction fonction sans preciser 
d'abord un prototype pour cette fonction. 

Call to undefined function fonction Erreur du compilateur 

Alors que la declaration de la fonction courante dans le fichier source indique le renvoi d'un type autre que void en C++ (ou 
int en C), le compilateur a detecte un renvoi sans aucune valeur. II s'agit en general d'une erreur. Les fonctions int ne sont 
pas concernees en C car dans des versions precedentes du langage C, le type void n'etait pas disponible pour definir une 
fonction ne renvoyant aucune valeur. 
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virtual can only be used with member functions 

Une donnee membre a ete declaree avec le specificateur virtual reserve exclusivement aux fonctions membres. Exemple : 

class myclass 

{ 

public : 

virtual int a; // erreur 

}; 

Cannot access an inactive scope Erreur du compilateur 

Vous avez essaye d'evaluer ou d'acceder a une variable locale a une fonction qui n'est pas en cours d'activite. Ce message 
devaluation d'expression est interne au debogueur integre. 

Cannot add or subtract relocatable symbols Erreur du compilateur 

La seule operation arithmetique qui peut etre effectuee sur un symbole relogeable dans un operande en assembleur est 
I'addition ou la soustraction d'une constante. Les variables, procedures, fonctions et etiquettes sont des symboles 
reaffectables. En supposant que Varsoit une variable et Const une constante, les instructions 

MOV AX, Const+Const 

et 

MOV AX,Var+Const 

sont correctes ; instruction mov ax, var+var ne I'est pas. 

Cannot allocate a reference Erreur du compilateur 

Vous avez essayer de creer une reference avec I'operateur new. Cette operation n'est pas autorisee car une reference n'est 
pas un objet et ne peut done etre cree a I'aide de cet operateur. 

identificateur cannot be declared in an anonymous union Erreur du compilateur 

Le compilateur a detecte une declaration de fonction membre ou de membre statique dans une union anonyme. Ce type 
d'union peut uniquement contenir des donnees membres. 

fonction 1 cannot be distinguished from fonction2 Erreur du compilateur 

Les listes de types de parametres dans la declaration de ces deux fonctions sont trop similaires pour pouvoir distinguer ces 
fonctions. Modifiez I'ordre des parametres ou le type d'un parametre dans I'une des declarations. 

Cannot call mainirom within the program Erreur du compilateur 

II est impossible d'appeler la fonction main de fagon recursive en C++. 

Cannot call near class member function with a pointer of type type Erreur du compilateur 

Les fonctions membres de classes de type near (rappel : les classes sont de type near par defaut dans les modeles de 
memoire TINY, SMALL et MEDIUM) ne peuvent pas etre appelees a I'aide de pointeurs de membres de type far ou huge. 
Remarquez que cela s'applique egalement a des appels utilisant un pointeur sur membre. Redefinissez le type du pointeur a 
near ou declarez la classe comme far. 

Cannot cast from type 1 to type2 Erreur du compilateur 

Impossible de transtyper typel en type2. En C, un pointeur peut etre convert en type entier ou en un autre pointeur. Un type 
entier peut etre converti en type entier, flottant ou pointeur. Un type flottant peut etre converti en type entier ou flottant. Les 
types structure et tableau ne peuvent etre converts ni etre le type resultant d'une conversion. II est impossible de convertir un 
type void. 
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En C++, si une instruction de conversion ou un constructed defini par I'utilisateur est detecte, les regies de priorite de types 
s'appliquent (sauf pour les pointeurs vers membres de classe). Parmi les types entiers, seule une constante nulle peut etre 
transtypee en pointeur membre. Un pointeur membre peut etre transtype en entier ou en pointeur membre similaire. Un 
pointeur membre similaire pointe vers une donnee membre ou vers un membre de fonction selon le comportement du 
pointeur initial. La classe qualifiante du type resultant de la conversion doit etre identique a I'originale ou etre une classe de 
base de I'originale. 

Cannot con vert type 1 to type2 Erreur du compilateur 

L'execution d'une instruction, d'une initialisation ou d'une expression depend de la conversion de type specifiee mais cette 
conversion n'est pas autorisee. 

Cannot create instance of abstract class classe Erreur du compilateur 

Une classe abstraite (contenant des fonctions pures de type virtuel) n'est pas utilisable directement mais uniquement de 
fagon derivee. 

Cannot define a pointer or reference to a reference Erreur du compilateur 

II est impossible de definir un pointeur vers une reference ou une reference a une reference. 

Cannot find classe::classe(classe &) to copy a vector Erreur du compilateur 

Si une classe classe! contient un vecteur (tableau) de classe classe2, et que vous vouliez construire un objet de type classel 
a partir d'un autre objet de type classel, vous devez definir un constructed ciasse2 : :ciasse2 (ciasse2&) pour 
pouvoir construire les elements de ce vecteur. Ce constructeur, appele constructeur de copie, accepte une reference a sa 
classe comme unique parametre. 

En regie generale, le compilateur fournit automatiquement un constructeur de copie. Neanmoins, si vous avez defini un 
constructeur pour la classe classe2 qui a un parametre de type classe2& et d'autres parametres a valeur par defaut, le 
constructeur de copie ne peut pas etre genere par le compilateur. Ceci est du au fait que 

classe2 : :classe2 (classe2&) etclasse2 : :classe2 (classe2&, int = 1 ) ne peuvent etre 
differenciees. Vous devez redefinir ce constructeur afin qu'une partie seulement des parametres aient une valeur par defaut. 
Vous pouvez creer un constructeur de copie ou laisser le compilateur en creer un. 

Cannot find c/asse::operator=(c/asse&) to copy a vector Erreur du compilateur 

En C++, si une classe classel contient un vecteur (tableau) de classe classe2 et que vous vouliez copier une classe de type 
classel, vous devez definir une operateur d'affectation ciasse2 : :operateur= (ciasse2&) afin que les elements 
du vecteur puissent etre copies. En regie generale, le compilateur fournit cet operateur automatiquement. Neanmoins, si vous 
avez defini un operateur = pour la classe classe2 (a condition que cet operateur n'accepte pas de parametre de type 
classe2&), vous devrez le specifier explicitement car le compilateur ne le fournit pas automatiquement. 

Cannot find default constructor to initialize array element of type classe Erreur du compilateur 

Lorsque vous declarez un tableau d'une classe comportant des constructeurs, vous devez soit initialiser explicitement chaque 
element du tableau, soit definir la classe avec un constructeur par defaut (celui-ci sera utilise pour initialiser les elements du 
tableau qui n'ont pas d'initialisateur explicite). Un constructeur par defaut est defini pour une classe par le compilateur a 
moins que vous n'ayez deja defini un constructeur pour cette classe. 
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Cannot find default constructor to initialize base class classe Erreurdu compilateur 

En C++, si une classe derivee classe2 est construite, chaque classe de base classel doit etre construite au prealable. Si le 
constructeur de classe2 ne specifie aucun constructeur pour classel (Indus dans I'en-tete de classe2), vous devez definir un 
constructeur classel : :ciassei () pour la classe de base. Ce constructeur sans parametres est appele le 
constructeur par defaut. II est fourni automatiquement par le compilateur a moins que vous ayez deja defini un constructeur 
pour la classe classel Dans ce cas, vous devrez specifier le constructeur par defaut explicitement car le compilateur ne le 
fournit pas automatiquement. 

Cannot find default constructeur to initialize member identificateur Erreur du compilateur 

En C++, si une classe classel contient un membre de la classe classe2, et que vous vouliez construire un objet de type 
classel, vous devez definir un constructeur ciasse2 : : ciasse2 ( ) pour que le membre puisse etre construit. Ce 
constructeur sans parametre est appele le constructeur par defaut. II est fourni automatiquement par le compilateur a moins 
que vous ayez deja defini un constructeur pour la classe classe2. Dans ce cas, vous devrez specifier le constructeur par 
defaut explicitement car le compilateur ne le fournit pas automatiquement. 

Cannot find MAKE.EXE Erreur de MAKE 

L'outil MAKE est introuvable. Verifiez que le fichier MAKE.EXE figure dans le repertoire en cours ou dans un repertoire 
specifie par la variable d'environnement PATH. 

Cannot generate COM file: data below initial CS:IP defined Erreur de I'editeurde liens 

Ce message est du a la generation de donnees de code en dessous de I'adresse de debut (1 00 en general) d'un fichier 
.COM. Verifiez que I'adresse de debut se situe a 1 00 a I'aide de la commande (ORG 1 00H). Ce message d'erreur ne devrait 
pas s'afficher pour des programmes rediges dans un langage de haut niveau. Si c'est pourtant le cas, verifiez que le module 
objet de code de demarrage (COx) approprie est utilise dans I'edition de liens. 

Cannot generate COM file: invalid initial entry point address Erreur de I'editeurde liens 

L'option /Tdc ou /t a ete utilisee mais I'adresse de debut du programme ne correspond pas a I'adresse 100H (requise avec 
les fichiers .COM). 

Cannot generate COM file: program exceeds 64K Erreur de I'editeur de liens 

L'option /Tdc ou /t a ete utilisee mais la taille totale du programme depasse la limite imposee aux fichiers .COM. 

Cannot generate COM file: segment-relocatable items present Erreur de I'editeur de liens 

L'option /Tdc ou /t a ete utilisee mais le programme contient des readressages de segments non autorises avec les fichiers 
.COM. 

Cannot generate COM file: stack segment present Erreur de I'editeur de liens 

L'option /Tdc ou /t a ete utilisee mais le programme declare un segment de pile non autorise avec les fichiers .COM. 

Cannot generate fonction from template function template Erreur du compilateur 

Un appel de fonction template a ete detecte, mais il est impossible de creer une fonction template a partir de la fonction 
appelee. 

Cannot have a non-inline function in a local class Erreurdu compilateur 

Cannot have a static data member in a local class Erreur du compilateur 

Tous les membres des classes declarees locales a une fonction doivent etre entierement definies dans la definition de classe. 
En d'autres termes, ce type de classes locales ne peut contenir aucune donnees membres statiques et les corps de toutes 
les fonctions membres de ces classes doivent etre definies dans la definition de classe. 
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Cannot have multiple paths for implicit rule Erreurde MAKE 

Chaque extension dans une regie implicite doit etre designee par un seul chemin. Des listes de plusieurs chemins sont 
autorisees uniquement pour des dependants dans une regie explicite. Par exemple : 

{pathl;path2 } . c.obj : # Incorrect 

{pathj.c.obj # Correct 

Cannot have path list for target Erreur de MAKE 

Vous pouvez specifier une liste de chemins uniquement pour des dependants dans une regie explicite. Par exemple : 

{pathl;path2 }prog. exe : prog.obj # Incorrect 

prog.exe: {pathl;path2 }prog. ob j # Correct 

Cannot initialize a class member here Erreur du compilateur 

Les membres individuels d'une structure, d'une union ou d'une classe ne peuvent etre definis avec des initialisateurs. Une 
structure ou une union peut etre initialisee globalement a I'aide d'initialisateurs s'ils figurent entre accolades. Une classe 
C++ peut etre initialisee uniquement a I'aide d'un constructeur. 

Cannot initialize typel with type2 Erreur du compilateur 

Impossible d'initialiser I'objet de type typel avec la valeur de type type2. Les regies d'initialisation sont pour I'essentiel 
identiques a celle de I'affectation. 

Cannot modify a const object Erreur du compilateur 

Operation non autorisee sur un objet declare comme constante (comme une affectation a cet objet). 

Cannot overload 'main' Erreur du compilateur 

Impossible de surcharger la fonction main. 

fonction cannot return a value Erreur du compilateur 

Une fonction definie avec le type de valeur renvoyee void contient une instruction return qui renvoie une valeur d'un autre 
type (par exemple une valeur de type int). 

identificateur cannot start a parameter declaration Erreur du compilateur 

Un identificateur non defini a ete detecte au debut d'un argument dans un declarateur de fonction. 

Ce message indique souvent une erreur d'utilisation de fichier d'en-tete ou que le nom de type a ete mal orthographie ou que 
le type n'a pas ete declare. 

identificateur cannot start an argument declaration Erreur du compilateur 

Un identificateur non defini a ete detecte au debut d'un argument dans un declarateur de fonction. Ce message indique 
souvent une erreur d'utilisation de fichier d'en-tete ou que le nom de type a ete mal orthographie ou que le type n'a pas ete 
declare. 

Cannot take address of main Erreur du compilateur 

En C++, il est impossible de recuperer I'adresse de la fonction main. 

Cannot throw type ■■ ambiguous base class base Erreur du compilateur 

II est impossible d'associer a une clause throw une classe qui contient plusieurs copies d'une classe de base non virtuelle. 

Cannot write GRPDEF list, extended dictionary aborted Erreur du bibliothecaire 

Impossible d'ajouter le dictionnaire etendu a la fin du fichier de bibliotheque. Ce message indique en general un espace 
insuffisant sur le disque. 
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Can't grow LE/LIDATA record buffer Erreur du bibliothecaire 

Erreur de ligne de commande. Reportez-vous au message Out of memory reading LE/LIDATA record from object 
module. 

Case bypasses initialization of a local variable Erreur du compilateur 

En C++, il est impossible d'omettre I'initialisation d'une variable locale. Dans ce cas, une etiquette case peut transferer ie 
controle apres cette variable locale. 

Case outside of switch Erreur du compilateur 

Le compilateur a detecte une instruction case a I'exterieur d'une instruction switch. Un erreur d'accolades est souvent a 
I'origine de ce message. 

Case statement missing : Erreur du compilateur 

Une instruction case doit comporter une expression constante suivi d'un signe deux-points (:). Verifiez que cette expression 
se termine par un signe deux-points ou qu'aucun autre symbole n'a ete specifies avant ce signe. 

catch expected Erreur du compilateur 

Dans un programme en C++, un bloc fry doit etre suivi par au moins un bloc catch. 

Character constant must be one or two characters long Erreur du compilateur 

La longueur d'une constante de type caractere est limitee a un ou deux caracteres uniquement. 

Circular dependency exists in makefile Erreur de MAKE 

Lefichier MAKE indique qu'un fichier doit etre mis a jour avant de pouvoir etre construit. L'exemple suivant utilise les regies 
explicites 

fichiera; fichier£> 
fichierij; fichierc 
fichierc; fichiera 

Selon ces regies, le fichiera depend du fichierb, qui depend a son tour du fichierc, lequel depend finalement du fichiera. Ces 
regies sont incorrectes dans la mesure oil un fichier ne peut dependre indirectement ou directement de lui-meme. 

Class classe may not contain pure functions Erreur du compilateur 

La classe declaree ne peut etre abstraite et ne peut done pas contenir de fonctions pures. 

Class member membre declared outside its class Erreur du compilateur 

Les fonctions membres d'une classe C++ peuvent etre declarees uniquement a I'interieur de la declaration de cette classe. A 
la difference des fonctions non membres, elles ne peuvent pas etre declarees a plusieurs reprises ou en d'autres endroits 
d'un programme. 

Code has no effect Mise en garde du compilateur 

Le compilateur a detecte une instruction dont les operateurs n'ont aucun effet. Par exemple, I'instruction 

a + b; 

n'a d'effet sur aucune des variables. Loperation est superflue et ce message indique un bug dans le fichier. 

Colon expected Erreur de MAKE 

Signe deux-points (:) manquant a la fin de la regie implicite. 

. c . ob j : # Correct 
. c.obj # Incorrect 
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Command arguments too long Erreurde MAKE 

La longueur de la chaine d'arguments passes a la commande est superieure a 51 1 caracteres (limite imposee par DOS). 

Command syntax error Erreur de MAKE 

Ce message s'afficha dans les cas suivants : 

■ la premiere ligne de regie du fichier MAKE etait precedee d'espaces blancs ; 

■ une regie implicite n'est pas conforme a la syntaxe .extext: ; 

■ une regie explicite ne comporte pas de nom avant le caractere : ; 

■ une definition de macro ne comporte pas de nom avant le caractere =. 

Command too long Erreur de MAKE 

La longueur de la commande est superieure a 512 caracteres. II peut etre utile d'avoir recours a un fichier de recherche. 

Common segment exceeds 64K Erreur de I'editeur de liens 

Le programme comporte plus de 64 ko de donnees de type near non initialisers. Essayez de declarer certaines de ces 
donnees avec le type far. 

Compiler could not generate copy constructor for class classe Erreur du compilateur 

Le compilateur ne peut pas generer de constructeur de copie pour des raisons de regies linguistiques. 

Compiler could not generate default constructor for class classe Erreur du compilateur 

Le compilateur ne peut pas generer de constructeur par defaut pour des raisons de regies linguistiques. 

Compiler could not generate operators for class classe Erreur du compilateur 

Le compilateur ne peut pas generer un operateur d'affectation requis pour des raisons de regies linguistiques. 

Compiler table limit exceeded Erreur du compilateur 

Debordement de I'une des tables internes du compilateur du en general a un nombre trop important de corps de fonction 
dans le module compile. Vous ne resoudrez pas ce probleme en liberant simplement de la memoire ne permet pas de 
resoudre ce probleme, vous devez simplifier le fichier a compiler. 

Compound statement missing } Erreur du compilateur 

Le compilateur a atteint la fin du fichier source sans trouver d'accolade fermante. Verifiez les differents niveaux d'accolades. 

Condition is always false Mise en garde du compilateur 

Condition is always true Mise en garde du compilateur 

Le compilateur a detecte une comparaison de valeurs dont le resultat est toujours vrai ou faux, comme dans I'exemple 
suivant : 

void proc (unsigned x) { 

if (x >= 0) { /* toujours 'true' */ 



Conflicting type modifiers Erreur du compilateur 

Ce message signale une declaration ou un pointeur est defini en meme temps avec les types near et far. Un pointeur ne peut 
etre defini qu'avec un seul modificateur d'adressage et une fonction ne peut etre definie qu'avec un seul modificateur de 
langage (cdecl, pascal ou interrupt). 
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symbole conflicts with module module in module module Mise en garde de I'editeur de liens 

Incoherence dans la definition du symbole indique. TLINK a detecte une fonction virtuelle et une definition commune portant 
le meme nom. 

Constant expression required Erreurdu compllateur 

Un tableau doit etre declare avec une taille constante. Cette erreur est generalement due a une constante mal orthographiee 
dans une directive #define. 

Constant is long Mise en garde du compilateur 

Le compilateur a detecte une constante decimale superieure a 32 767 ou une constante octale (ou hexadecimale) superieure 
a 65 535 non suivie du caractere /ou L La constante est interpretee comme etant de type long. 

Constant member membre in class without constructors Erreurdu compilateur 

Une classe contenant des membres de type constante doit etre definie avec au moins un constructeur defini par I'utilisateur 
afin de pouvoir initialiser ces membres. 

Constant member membre is not initialized Mise en garde du compilateur 

Cette classe C++ contient un membre de type constante non initialise. Remarquez qu'il est seulement possible d'initialiser un 
membre de type constante, toute affectation est impossible. 

Constant out of range in comparison Mise en garde du compilateur 

Le fichier source comporte une comparaison avec une sous-expression de type constant en dehors des valeurs limites 
autorisees par le type de I'autre sous-expression. Par exemple, la comparaison d'une quantite unsigned a -1 n'a pas de 
sens. Pour obtenir une constante unsigned superieure a 32 767 (en decimal), vous devez transtyper la constante en 
unsigned ou ajouter la lettre uou L/apres la constante. 

Si ce message s'affiche, le compilateur genere quand meme le code pour effectuer la comparaison. Si ce code produit 
toujours le meme reultat (comme comparer une expression de type char a 4000), le code effectuera toujours ce test. 

Constant variable variable must be initialized Erreurdu compilateur 

Cet objet C++ est declare comme constante mais n'est pas initialise. Comme il est impossible de lui affecter une valeur, 
I'objet doit etre initialise lors de sa declaration. 

Constructor cannot be declared const or volatile Erreurdu compilateur 

Un constructeur ne peut pas etre declare const et/ou volatile. 

Constructor cannot have a return type specification Erreur du compilateur 

Le type de la valeur de renvoi des constructeurs C++ utilise par le compilateur est implicite. II est done impossible de declarer 
un type de renvoi ou de renvoyer une valeur. 

Conversion may lose significant digits Mise en garde du compilateur 

Pour un operateur d'affectation ou une autre operation, vous devez effectuer une conversion de type long ou unsigned long 
en type int ou unsigned int. Ce type de conversion peut modifier le fonctionnement et le resultat d'un programme puisque 
les variables de type int et long sont de tailles differentes. 

Conversion of near pointer not allowed Erreurdu compilateur 

Impossible de convertir un pointeur near en pointeur far dans la boite devaluation d'expression lorsque le programme n'est 
pas en cours d'execution. La conversion ne dispose pas de la valeur courante de DS generee dans le programme utilisateur. 

Conversion operator cannot have a return type specification Erreur du compilateur 

La fonction membre de conversion de types C++ specifie un type de valeur de renvoi different de son propre type. La fonction 
de conversion operator ne peut etre declaree avec un type de valeur de renvoi. 
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Conversion to type will fail for members of virtual base classe Erreurdu compilateur 

Ce message s'affiche dans les quelques cas de conversion du type d'un pointeur membre dans le type d'un autre pointeur 
membre, si la classe du pointeur membre contient des classes virtuelles, et uniquement si I'option -Vv ou les options EDI 
Options|Compiler|Advanced Compiler|Deep Virtual Bases ont ete utilisees. II indique que si le pointeur membre transtype 
pointe vers un membre de la classe classe (au moment du transtypage), la conversion ne peut etre effectuee et le 
transtypage genere un pointeur membre NULL. 

Could not allocate memory for per module data Erreurdu bibliothecaire 

Memoire insuffisante pour le bibliothecaire. 

Could not create list file nomjichier Erreurdu bibliothecaire 

Impossible de creer le fichier de listage pour la bibliotheque. L'espace sur le disque est peut etre sature. 

Could not find a match for argument(s) Erreur du compilateur 

Aucune fonction C++ dont les parametres correspondent aux parametres fournis n'a pu etre trouvee. 

Could not find file nomjichier Erreurdu compilateur 

Impossible de trouver le fichier specifie dans la ligne de commande. 

Could not get procedure address from DLL nomjichier Erreur de I'editeur de liens 

L'editeur de liens n'a pas pu extraire de procedure de la bibliotheque DLL indiquee. Verifiez que vous disposez de la version 
appropriee de la bibliotheque DLL. 

Could not load DLL nomjichier 

L'editeur de liens n'a pas pu charger la bibliotheque DLL specifiee. Verifiez que cette bibliotheque est declaree dans la varible 
d'environnement PATH. 

Could not write output Erreur du bibliothecaire 

Le bibliothecaire n'a pas pu generer le fichier de sortie. 

Couldn't alloc memory for per module data Erreurdu bibliothecaire 

Memoire insuffisante pour le bibliothecaire. 

nomjichier couldn't be created, original won't be changed Mise en garde du bibliothecaire 

Tentative a ete faite d'extraire un objet (action '*') mais le bibliothecaire ne peut pas creer le fichier objet pour extraire le 
module. L'objet existe peut-etre deja et est accessible en lecture seulement ou le disque est sature. 

Couldn't get LE/LIDATA record buffer Erreur du bibliothecaire 

Erreur de ligne de commande. Reportez-vous au message Out of memory reading LE/LIDATA record from object 
module. 

Debug info switch ignored for .COM files Mise en garde de I'editeur de liens 

Borland C++ n'inclut pas les informations de debogage pour les fichiers .COM. 

Debug information enabled, but no debug information found in OBJs Mise en garde de I'editeur de liens 

Aucune partie de I'application n'a ete compilee avec des informations de debogage bien que vous ayez active ces 
informations dans I'edition de liens. 

Debug information in module module will be ignored Mise en garde de I'editeur de liens 

Les fichiers objets compiles avec des informations de debogage ont un enregistrement de version. La version principale de 
cet enregistrement est plus elevee que celle supportee actuellement par TLINK. TLINK n'a pas genere les informations de 
debogage du module en question. 
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Debugging information overflow; try fewer modules with debuginf o Erreur de I'editeur de liens 

L'edition de liens comporte trap de modules contenant des informations de debogage. Recompilez le programme avec moins 
de modules marques pour des informations de debogage. 

Declaration does not specify a tag or an identifier Erreur du compilateur 

Erreur de declaration : variable ou code de compilation conditionnelle manquant dans la declaration d'une structure ou d'une 
union. En C++, cette declaration est obligatoire. 

Declaration is not allowed here Erreur du compilateur 

Impossible d'utiliser une declaration comme instruction de controle d'une instruction while, for, do, if ou switch. 

Declaration missing ; Erreur du compilateur 

Point-virgule manquant a la fin d'une declaration. 

Declaration syntax error Erreur du compilateur 

Symbole manquant ou ajoute par erreur dans une declaration. 

Declaration terminated incorrectly Erreur du compilateur 

Caractere de terminaison incorrect ou ajoute par erreur dans une declaration (par exemple, un point-virgule ajoute a la suite 
du corps d'une fonction). Ce message s'affiche egalement si un point-virgule figure par erreur entre I'en-tete et I'accolade 
ouvrante gauche dans la declaration d'une fonction membre C++ dans une classe. 

Declaration was expected Erreur du compilateur 

Declaration manquante. Erreur due generalement a I'absence d'un delimiteur (virgule, point-virgule, parenthese droite ou 
accolade droite). 

Declare operator delete (void*) or (void*, sizej) Erreur du compilateur 

Declarez l'operateur delete avec un seul parametre void* ou un second parametre de type sizej. Si vous utilisez la seconde 
version, elle sera utilisee de preference a la premiere. L'operateur global delete ne peut etre declare qu'avec le parametre 
void*. 

Declare Operator delete[ ] (void*) or (void*, sizej) Erreur du compilateur 

Declarez l'operateur delete avec I'une des syntaxes suivantes : 

■ avec un seul parametre void* ; 

■ avec un second parametre de type sizej. 

Si vous utilisez la seconde version, elle sera utilisee de preference a la premiere. L'operateur global delete ne peut etre 
declare qu'avec le parametre void*. 

Declare type type prior to use in prototype Mise en garde du compilateur 

Lorsqu'un prototype de fonction fait reference a un type de structure qui n'a pas ete declare au prealable, une declaration a 
I'interieur du prototype est differente d'une declaration a I'exterieur du prototype. Par exemple : 

int f une ( struct s *ps); 
struct s { /* ... */ }; 

Dans la mesure ou il n'y a pas de structure s a la portee du prototype de la fonction func, le parametre ps est un pointeur vers 
une structure s non definie qui ne doit pas etre confondue avec la structure s declaree sur la ligne suivante. Ceci genere des 
messages d'erreur et de mise en garde d'incompatibilite des types. Pour resoudre le probleme, deplacez la declaration de la 
structure s avant le prototype qui s'y refere ou ajoutez la declaration de type incomplete struct s ; avant le prototype qui 
fait reference a la structure s. Si le parametre de fonction est une structure, plutot qu'un pointeur vers une structure, la 
declaration incomplete ne suffit pas. Vous devez alors specifier la declaration de cette structure avant le prototype. 
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Default argument value redeclared Erreurdu compilateur 

Lorsqu'un parametre de fonction C++ est declare avec une valeur par defaut, cette valeur ne peut pas etre modifiee, 
redeclaree ou omise dans une autre declaration de la meme fonction. 

Default argument value redeclared for parameter parametre Erreurdu compilateur 

Lorsqu'un parametre de fonction C++ est declare avec une valeur par defaut, cette valeur ne peut pas etre modifiee, 
redeclaree ou omise dans une autre declaration de la meme fonction. 

Default expression may not use local variables Erreurdu compilateur 

Une expression d'argument par defaut ne peut utiliser aucune variable locale ni aucun parametre. 

Default outside of switch Erreur du compilateur 

Le compilateur a detecte une instruction default en dehors d'une instruction switch. Verifiez les niveaux d'accolades. 

Default value missing Erreurdu compilateur 

Lorsqu'une fonction C++ declare un parametre avec une valeur par defaut, tous les parametres suivants doivent egalement 
avoir une valeur par defaut. Dans cette declaration, un parametre avec une valeur par defaut etait suivi d'un parametre sans 
valeur par defaut. 

Default value missing following parameter parametre Erreurdu compilateur 

Une valeur par defaut doit etre specifiee pour tous les parametres suivant le premier parametre qui a ete defini avec une 
valeur par defaut. 

Define directive needs an identifier Erreurdu compilateur 

Le premier caractere (different d'un espace blanc) apres une instruction #define doit etre un identificateur. Le compilateur a 
detecte un autre caractere. 

symbole defined in module module is duplicated in module module Erreur de I'editeur de liens 

Conflit entre deux symboles (de type "public" ou "communal") du a la definition du meme symbole dans deux modules. Une 
erreur se produit si ces definitions sont detectees en meme temps dans le(s) fichier(s) objet car TLINK ne peut determiner la 
definition appropriee. Un message de mise en garde s'affiche si TLINK detecte I'un des symboles dans une bibliotheque et 
I'autre symbole dans un fichier .OBJ. Dans ce cas, TLINK utilise celui du fichier .OBJ. 

Delete array size missing ] Erreurdu compilateur 

Crochet fermant manquant a la fin du specificateur de tableau d'un operateur. 

Destructor cannot be declared const or volatile Erreur du compilateur 

Declaration d'un destructeur de type const et/ou volatile non autorisee. 

Destructor cannot have a return type specification Erreur du compilateur 

II est impossible de specifier le type "return" pour un destructeur. 

Destructor for classe is not accessible Erreur du compilateur 

Le destructeur de cette classe C++ est protege ou prive et est done inaccessible pour detruire la classe. Si un destructeur de 
classe est prive, la classe ne peut pas etre detruite et ne peut done jamais etre utilisee. II s'agit probablement d'une erreur. 
Un destructeur protege est accessible uniquement a partir de classes derivees. Ceci permet de verifier qu'aucune instance 
d'une base n'a ete creee mais uniquement les classes qui en derivent. 
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Destructor for classe required in conditional expression Erreurdu compilateur 

Si le compilateur doit creer une variable locale temporaire dans une expression conditionnelle, elle est mal placee pour 
appeler le destructeur etant donne que cette variable peut ou non avoir ete initialisee. La variable temporaire peut etre creee 
explicitement, comme avec nom-ciasse (vai, vai) ou implicitement a I'aide d'une autre instruction. Revisez le 
code pour eliminer cette valeur temporaire. 

Destructor name must match the class name Erreur du compilateur 

Dans une classe C++, le tilde () introduit une declaration de destructeur de classe. Le nom du destructeur doit correspondre 
au nom de la classe. Ce message indique que le tilde precedait un autre nom. 

Divide error Erreur d'execution 

Impossible de diviser un entier par zero. Par exemple : 

int n = 0; 
n = 2 / n; 

Ce message peut etre intercepts a I'aide de la fonction signal. Autrement, Borland C++ apelle la procedure d'interruption 
abort pour mettre fin au programme. 

Division by zero Erreur du compilateur 

Un operateur de division ou de reste a ete specifie dans une expression constante avec un diviseur nul. 

Division by zero Mise en garde du compilateur 

Une expression avec operateur de division ou de reste comporte un diviseur egal a zero. 

Division by zero Erreur de MAKE 

Un operateur de division ou de reste dans une instruction !if specifie un diviseur egal a zero. 

do statement must have while Erreurdu compilateur 

Mot cle while manquant a la fin d'une boucle de repetition do. 

nomjichier does not exist ■ don't know how to make it Erreur de MAKE 

Nom de fichier inexistant dans la sequence de compilation. Aucune regie ne permet la creation du fichier nomjichier. 

DOS error, ax = numero Erreur de I'editeur de liens 

Message genere si un appel DOS a renvoye une erreur inattendue. La valeur ax affichee correspond a un code d'erreur. II 
indique une erreur interne a TLINK ou une erreur DOS. Les appels DOS effectues par TLINK qui pourraient provoquer cette 
erreur sont read, write, seek et close. 

do-while statement missing ( Erreurdu compilateur 

Parenthese gauche manquante apres le mot cle while dans une boucle de repetition do. 

do-while statement missing ) Erreurdu compilateur 

Parenthese droite manquante apres I'expression de test dans une boucle de repetition do. 

do-while statement missing ; Erreurdu compilateur 

Point-virgule manquant apres la parenthese droite dans I'expression de test d'une boucle de repetition do. 

Duplicate case Erreur du compilateur 

Les instructions case d'un branchement conditionnel switch doivent avoir des valeurs d'expression constante toutes 
differentes. 

Duplicate Handler for typel, already had type2 Erreurdu compilateur 

Impossible de specifier deux gestionnaires pour le meme type. 
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Duplicate ordinal for exports: string (ordvall) and string (ordval2) Erreur de I'editeur de liens 

Deux exports ont ete trouves pour le meme symbole mais avec des valeurs ordinales differentes. Utilisez la meme valeur 
ordinale ou supprimez Tun des exports. 

Empty LEDATA record in module module Mise en garde de I'editeur de liens 

Cette mise en garde s'affiche si le convertisseur emet un enregistrement de donnees contenant des donnees. Contactez le 
support technique du convertisseur utilise. Cet enregistrement ne devrait pas entrainer d'effets secondaires. 

Enum syntax error Erreur du compilateur 

Liste d'identificateurs mal formee dans une declaration enum. 

Error changing file buffer size Erreur du bibliothecaire 

Le bibliothecaire essaye d'ajuster la taille d'un tampon utilise a la lecture ou I'ecriture d'un fichier mais la memoire est 
insuffisante. Pour resoudre ce probleme, vous devrez liberer de la memoire systeme. 

Error directive: message Erreur du compilateur 

Affichage du texte de la directive #error en cours de traitement dans le fichier source. 

Error directive: message Erreur de MAKE 

MAKE a traite une directive #error dans le fichier source et le texte de cette directive est affiche dans ce message. 

Error opening nomjichier Erreur du bibliothecaire 

Le bibliothecaire n'a pas pu ouvrir le fichier specifies. 

Error opening nomjichier ior output Erreur du bibliothecaire 

Le bibliothecaire ne peut pas ouvrir le fichier specifie pour ecrire la sortie. Ceci est generalement du a un espace disque 
insuffisant pour la bibliotheque cible ou un fichier de listage. Cette erreur se produit a la fermeture du fichier cible qui est 
cependant marque comme un fichier accessible en lecture seulement. 

Error renami ng tichier_a to fichier_b Erreur du bibliothecaire 

Le bibliothecaire cree une bibliotheque dans un fichier temporaire, puis attribue le nom du fichier de bibliotheque cible a ce 
fichier temporaire. Ce message s'affiche en cas de probleme (du generalement a un espace disque insuffisant). 

Error writi ng output fi le Erreur du compilateur 

Une erreur DOS empeche Borland C++ d'ecrire un fichier .OBJ, .EXE ou temporaire. Verifiez que le repertoire de sortie est 
valide et que I'espace disque est suffisant. 

_except or _finally expected following _try Erreur du compilateur 

En C, un bloc fry doit etre suivi d'un bloc de traitement de zones _except ou _finally. 

Exception handling variable may not be used here Erreur du compilateur 

Tentative a ete faite d'utiliser I'une des valeurs de traitement d'exceptions reservees a des constructions de traitement 
d'exceptions particulieres (comme GetExceptionCode()). 

Exception specification not allowed here Erreur du compilateur 

Une declaration de type de pointeur de fonction ne peut pas contenir de specifications d'exceptions. 

Explicit stacks are ignored for PE images Mise en garde de I'editeur de liens 

Les applications 32 bits sont des applications au format PE qui ne disposent pas de piles explicites. Le segment de pile est lie 
dans I'image mais il n'est pas utilise comme pile de I'application. Le parametre de taille de pile est par contre utilise pour 
definir la taille de la pile et le systeme d'exploitation alloue une pile a cette application. 
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Export symbole is already imported Mise en garde de I'editeur de liens 

Impossible d'exporter un symbole egalement importe. 

Export symbole is duplicated Mise en garde de I'editeur de liens 

Ce message indique un conflit d'exportation de deux fonctions distinctes portant le meme nom. L'editeur de liens ne peut 
determiner quelle definition doit etre exportee a I'aide de _export. Le premier symbole est utilise par defaut. 

Expression expected Erreur du compilateur 

Expression manquante mais le symbole courant ne peut pas debuter une expression. Ce message s'affiche la ou I'expression 
controlante d'une clause if ou while est manquante ou a I'endroit de I'initialisation d'une variable. Ceci est generalement du a 
I'insertion ou la suppression accidentelle d'un symbole dans le code source. 

Expression of scalar type expected Erreur du compilateur 

Les operateurs de negation (!), decrementation (++) et de decrementation (-@hsp(0.2)-) requierent une expression scalaire 
de type char, short, int, long, enum, float, double, long double et pointer uniquement. 

Expression syntax Erreur du compilateur 

Le compilateur a detecte une erreur grave dans une expression (deux operateurs consecutifs, un erreur de parenthese ou un 
point-virgule manquant au niveau de I'instruction precedente sont les erreurs les plus frequentes). 

Expression syntax error in !if statement Erreur de MAKE 

L'instruction !if comporte une expression mal formee (parenthese, operateur ou constante manquant ou ajoute par erreur). 

raison - extended dictionary not created Mise en garde du bibliothecaire 

Le bibliothecaire n'a pas pu cree le dictionnaire etendu. La raison est indiquee dans le message. 

Extended dictionary not found in library nom_bibliotheque, IE option ignored Mise en garde de I'editeur de liens 

Avec I'option /E de TLINK, toutes les bibliotheques incluses dans I'edition de liens doivent avoir des dictionnaires etendus. Si 
une bibliotheque sans dictionnaire etendu est detectee lors d'une edition de liens avec I'option IE, I'editeur de liens 
abandonne le traitement des dictionnaires etendus et procede a une edition de liens par defaut. 

Extern variable cannot be initialized Erreur du compilateur 

La classe de stockage extern appliquee a une variable signifie que cette variable est declaree mais non definie a cet endroit. 
Aucune memoire de stockage ne lui est allouee. II est done impossible d'initialiser la variable dans la declaration. 

Extern symbole was not qualified with import in module module Mise en garde de I'editeur de liens 

Les applications Windows 32 bits qui font reference a des symboles importes doivent effectuer des operations d'indirection 
pour atteindre certaines donnees. Au niveau des appels, ces operations sont gerees automatiquement par I'editeur de liens. 
En ce qui concerne les references aux DATA importes, le compilateur doit generer une indirection pour que I'application 
fonctionne normalement. Le compilateur sait comment generer cette indirection lorsque le symbole est qualifies a I'aide de 

import. Ce message s'affiche si I'editeur de liens detecte une reference de segment a un symbole importe, et si le symbole 

n'a pas ete qualifie a I'aide de import. 

Extra argument in template class name template Erreur du compilateur 

Trap de valeurs ont ete specifies dans la liste des parametres formels du nom de classe template indique. 

Extra parameter i n cal I Erreur du compilateur 

Trap d'arguments ont ete specifies dans I'appel d'une fonction effectue par I'intermediaire d'un pointeur defini avec un 
prototype. 
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Extra parameter in call to fonction Erreurdu compilateur 

Trap d'arguments ont ete specifies dans I'appel de la fonction indiquee (definie avec un prototype). 

Failed to locate DPMI server (DPMI16BI.OVL) Erreurdu compilateur 

Failed to locate protected mode loader (DPMILOAD.EXE) Erreurdu compilateur 

Verifiez que les fichiers DPMI16BI.OVL et DPMILOAD.EXE sont accessibles a partir de la variable d'environnement PATH ou 
dans le meme repertoire que I'outil de ligne de commande en mode protege que vous avez essaye d'utiliser. 

Fai led read from nomjichier Erreur de I'editeur de liens 

L'editeur de liens n'a pas pu lire de donnees a partir du fichier indique. 

Fai led write to nomjichier Erreur de I'editeur de liens 

L'editeur de liens n'a pas pu ecrire de donnees dans le fichier indique. 

_far1 6 may only be used with _pascal or _cdecl Erreur du compilateur 

Si vous utilisez _far16 pour effectuer des appels de fonction ou faire reference a des donnees dans une bibliotheque DLL 16 
bits, ces fonctions et donnees ne peuvent etre modifiees que par pascal ou __cdecl.}] 

File must contain at least one external declaration Erreurdu compilateur 

L'unite de compilation etait logiquement vide et ne contenait aucune declaration externe. En ANSI C et C++, I'unite de 
compilation requiert au moins une declaration. 

Fi lename too long Erreur du compilateur 

La longueur du nom de fichier indique dans la directive #include est superieure a 260 caracteres (chemin d'acces compris). 
Le fichier n'a pas pu etre traite par le compilateur. 

File name too long Erreur de MAKE 

Le nom du chemin du fichier indique dans une directive linclude a fait deborder le tampon interne de MAKE (limite a une taille 
de 512 octets). 

nomjichier 1\\e not found Mise en garde du bibliothecaire 

Le bibliothecaire de ligne de commande a essaye d'ajouter un objet inexistant. La bibliotheque a quand meme ete creee. 

nom_f/c/?/e/'file not found Erreurdu bibliothecaire 

Pour creer une bibliotheque, I'EDI supprime la bibliotheque existante avant de la recreer. Si certains objets ne sont pas 
disponibles ou inexistants, la bibliotheque est considered comme incomplete et TLIB genere ce message. L'absence d'un 
objet peut indiquer que la compilation du module source n'a pas ete effectuee ou que des erreurs se sont produites lors de la 
compilation. Pour resoudre le probleme, executez une operation Compile|Make ou Compile|Build ou signalez les endroits oil 
se sont produites les erreurs. 

nomjichier (numjigne): file read error Erreur de I'editeur de liens 

Une erreur DOS s'est produite lorsque TLINK a lu le fichier de definition de module. Ce message indique generalement un fin 
de fichier prematuree. 

Fixup to zero length segment in module module Erreur de I'editeur de liens 

Un reference a ete specifiee apres la fin d'un segment d'image. Comme cette reference accederait a une adresse incorrecte, 
elle a ete signalee comme une erreur. 
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Fixup overflow at segment :xxxxh, target = segment xxxh in module module Mise en garde de I'editeur de liens 

Fixup overflow at segment.xxxxh, target = symbol in module module Mise en garde de I'editeur de liens 

Ces messages indiquent une reference a un code ou a une donnee incorrecte dans un fichier objet que TLINK doit corriger 
lors de I'edition de liens. 

Ceci est du a une incompatibilite de modeles de memoire. Un appel near d'une fonction dans un autre segment de code est 
la cause la plus probable. Cette erreur se produit egalement si vous generez un appel near a une variable de donnee ou une 
reference de donnee a une fonction. Dans un cas comme dans I'autre, le symbole indique comme target dans le message 
d'erreur correspond a la variable ou la fonction designee. La reference figure dans le module indique. Accedez au fichier 
source de ce module pour corriger la reference. 

Dans un programme en langage assembleur, des debordements de correction se produisent souvent si vous declarez une 
variable externe au sein d'une definition de segment. Cette variable figure en fait dans un autre segment. 

Si cette technique ne permet pas de diagnostiquer la cause du probleme, ou si vous utilisez le langage assembleur ou un 
langage de haut niveau autre que Borland C++, ce message peut avoir d'autres origines. Meme en Borland C++, ce message 
pourrait s'afficher si vous utilisez des noms de segment ou de groupe differents des valeurs par defaut d'un modele de 
memoire donne. 

Fixup to zero length segment in module nomjnodule Erreur de I'editeur de liens 

Cette erreur se produit generalement si vous effectuez une reference a un segment qui ne contient aucune donnee. Si le 
segment n'est pas groupe avec d'autres segments, le resultat est un segment physique de longueur nulle, ce qui est 
impossible en soi. L'editeur de liens ne peut done pas y faire reference. 

Floating point error: Divide by 0. Erreur d'execution 

Floating point error: Domain. Erreur d'execution 

Floating point error: Overflow. Erreur d'execution 

Ces erreurs fatales sont dues a une operation en virgule flottante dont le resultat n'est pas une valeur finie. 

■ "Divide by 0" indique que le resultat exact est +INF ou -INF (resultat de I'operation 1 .0/0.0, par exemple). 

■ "Domain" indique que le resultat est egal a NAN, e'est-a-dire non egal a un nombre). 

■ "Overflow" indique que le resultat est +INF (infini) ou -INF avec perte complete de precision (par exemple, affectation de 
1e200*1e200 a une variable de type double). 

Floating point error: Partial loss of precision. Erreur d'execution 

Floating point error: Underflow. Erreur d'execution 

Ces exceptions sont masquees par defaut et les messages correspondants ne s'affichent pas. Les depassements negatifs 
sont convertis en une valeur nulle et les pertes de precision sont ignorees. L'appel a _control87 permet de les demasquer. 

Floating point error: Stack fault. Erreur d'execution 

Erreur de la pile en virgule flottante. Cette erreur peut etre due a un code assembleur utilisant trop de registres ou a une 
fonction en virgule flottante declaree incorrectement. 

Ces erreurs peuvent etre evitees en masquant les exceptions pour qu'elles ne se produisent pas ou en interceptant une 
exception avec signal. Pour plus de details, reportez-vous aux fonctions_confro/87et signal. 
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Dans les cas precedents, le programme affiche le message d'erreur et fait appel a abort qui genere le message suivant : 

Abnormal program termination 

avant d'appeler_exit ( 3 ) . Pour plus de details, reportez-vous aux fonctions abort et_exit. 

for statement missing ( Erreur du compilateur 

Parenthese gauche manquante apres le mot cle for dans une boucle de repetition for. 

for statement missing ) Erreur du compilateur 

Parenthese droite manquante apres I'une des expressions de controle d'une boucle de repetition for. 

for statement missing ; Erreur du compilateur 

Point-virgule manquant apres I'une des expressions de controle d'une boucle de repetition for. 

Friends must be functions or classes Erreur du compilateur 

Seule une fonction ou une classe peut etre definie comme amie d'une classe C++. 

Function call missing ) Erreur du compilateur 

Erreur de syntaxe dans la liste d'arguments d'appel d'une fonction (parenthese droite manquante ou mal placee, par 
exemple). 

Function calls not supported Erreur du compilateur 

Les appels de fonctions (y compris les fonctions de conversion implicites, les constructeurs, les destructeurs, les operateurs 
surcharges et les fonctions inline) ne sont pas supportes dans revaluation d'expression du debogueur integre. 

Function defined inline after use as extern Erreur du compilateur 

Une fois utilisee, une fonction ne peut pas devenir une fonction inline. Deplacez la definition inline plus bas dans le fichier ou 
supprimez-la entierement. 

Function definition cannot be a Typedef'ed declaration Erreur du compilateur 

En ANSI C, un corps de fonction ne peut etre defini a I'aide d'une instruction typedef avec une fonction Type. 

Function fonction cannot be static Erreur du compilateur 

Seuls les fonctions membres ordinaires et le operateurs new et delete peuvent etre declares statiques. Les constructeurs, 
destructeurs et autres operateurs ne doivent pas etre statiques. 

Function fonction should have a prototype Erreur du compilateur 

Une fonction a ete appelee alors que son prototype etait hors de portee. 

EnC,int toto () ; n'est pas un prototype a la difference de int toto (int) ; oude int toto (void) ;. En 
C++, int toto(); est considere comme un prototype et est equivalent a int toto (void) ;. En C, les prototypes 
sont recommandes pour toutes les fonctions. En C++, les prototypes sont obligatoires pour toutes les fonctions. Dans tous les 
cas, une definition de fonction (constitute d'un en-tete et d'un corps de fonction) sert de prototype si elle apparait avant toute 
mention de la fonction. 

Function should return a value Mise en garde du compilateur 

Cette fonction a ete declaree (peut-etre implicitement) pour renvoyer une valeur. Le compilateur a detecte une instruction 
return sans valeur de renvoi ou a atteint la fin de la fonction sans trouver d'instruction return. Renvoyez une valeur ou 
declarez la fonction comme void. 
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Functions fonction 1 and fonction2 both use the same dispatch number Erreur du compilateur 

Probleme de table virtuelle distribute dynamiquement (table DDVT). Lorsque vous prenez le controle d'une fonction DDVT 
dans une classe derivee, utilisez le meme indice de distribution. Chaque fonction d'une meme hierarchie de classe doit 
utiliser un indice de distribution different. 

Functions cannot return arrays or functions Erreur du compilateur 

Une fonction ne peut pas renvoyer un tableau ou une fonction. Elle peut uniquement renvoyer un pointeur ou une reference a 
un tableau ou a une fonction. 

Functions containing local destructors are not expanded inline in function fonction Mise en garde du compilateur 

Borland C++ ne met pas oeuvre I'inlining pour la fonction inline que vous avez creee. Ce message n'est pas critique. La 
fonction est generee hors ligne. 

Functions containing mot reserve are not expanded inline Mise en garde du compilateur 

Une fonction contenant les mots reserves do, for, while, goto, switch, break, continue et case ne peuvent etre developpes 
en mode en ligne meme s'ils sont specifies comme inline. La fonction reste parfaitement correcte mais sera traitee comme 
une fonction statique ordinaire (et non globale). 

Functions may not be part of a struct or union Erreur du compilateur 

Le champ d'une structure ou d'une union (en langage C) a ete declare comme fonction et non comme pointeur vers une 
fonction. Ce type de declaration est uniquement autorise en C++. 

General error Erreur de I'editeur de liens 

General error in library file nomjichier'm module module near module file offset Qxyyyyyyyy Erreur de I'editeur de liens 

General error in module module near module file offsetOx yyyyyyyy Erreur de I'editeur de liens 

L'editeur de liens fournit autant d'informations que possible sur le traitement en cours au moment de I'erreur fatale. Notez les 
informations sur les fichiers .OBJ ou .LIB et contactez votre support technique Borland. 

General error Erreur de I'editeur de liens 

General error in module module Erreur de I'editeur de liens 

L'editeur de liens a detecte une erreur interne. Notez les circonstances de cette erreur et contactez votre support technique 
Borland. 

Global anonymous union not static Erreur du compilateur 

En C++, une union anonyme globale au niveau du fichier doit etre declaree statique. 

Goto bypasses initialization of a local variable Erreur du compilateur 

En C++, il n'est pas autorise d'omettre Initialisation d'une variable locale. Ce message s'affiche si une instruction goto 
essaie de transferer le controle une fois la variable locale passee. 

Goto Into an Exception Handler is Not Allowed 

II est impossible de passer a un bloc try ou un gestionnaire d'exceptions associe a un bloc try. 

Goto statement missi ng label Erreur du compilateur 

Le mot cle goto doit etre suivi d'un identificateur. 

Group groupe exceeds 64K Erreur de I'editeur de liens 

La taille totale des segments combines d'un groupe est superieure a 64 ko. 

Group overflowed maximum size: groupe Erreur du compilateur 

La taille totale des segments d'un groupe (par exemple, DGROUP) est superieure a 64 ko. 
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Group groupe 1 overlaps group groupe2 Mise en garde de I'editeur de liens 

TUNK a detecte des groupes imbriques. Ce message s'affiche lorsque des recouvrements sont utilises. 

Handler for type 1 hidden by previous handler for type2 Mise en garde du compilateur 

Ce message s'affiche si un gestionnaire d'un type D derive d'un type 6 est specifie apres un gestionnaire d'un type 6. Le 
gestionnaire de type D ne sera en effet jamais invoque. 

specif icateur has already been included Erreurdu compilateur 

Plusieurs occurrences de ce type de specificateur sont specifies dans cette declaration. Supprimez ou modifiez I'une de ces 
occurrences. 

Hexadecimal value contains more than 3 digits Mise en garde du compilateur 

Dans les versions precedentes de C, une sequence d'echappement hexadecimale pouvait comporter 3 chiffres maximum. La 
norme ANSI autorise I'utilisation d'un nombre quelconque de chiffres tant que la valeur peut se coder sur un octet. Ce 
message s'affiche si la sequence d'echappement hexadecimale est precedee de plusieurs zeros (comme dans "\x00045"). 
Dans les versions precedentes de C, cette chaine serait interpreted differemment. 

tonctionl hides virtual function fonction2 Mise en garde du compilateur 

Une fonction virtuelle d'une classe de base est generalement masquee par une declaration dans une classe derivee. Dans ce 
cas, une declaration avec le meme nom mais des types d'argument differents rend les fonctions virtuelles inaccessibles aux 
classes derivees creees ulterieurement. 

Identifier expected Erreur du compilateur 

Identificateur manquant. En C, un identificateur doit etre specifie dans une liste de parametres d'un en-tete de fonction 
(specifie selon les premieres specifications du C), apres les mots reserves struct ou union s'ils ne sont pas suivis d'une 
accolade fermante, et comme nom d'un membre dans une structure ou une union (sauf pour les champs de bits de largeur 
nulle). 

En C++, un identificateur doit etre specifie dans une liste de classes de base a partir desquelles une autre classe est derivee, 
apres deux signes deux-points (::) et apres le mot reserve operator lorsqu'aucun symbole d'operateur n'est present. 

Identifier identificateur cannot have a type qualifier Erreur du compilateur 

Impossible d'appliquer un qualificateur classev.identificateur. Vous nepouvezpas definirde qualificateur pour des noms 
typedef , des declarations de fonction (sauf des definitions au niveau du fichier), des variables locales ou des parametres de 
fonction, ou pour un membre de classe sauf si vous utilisez sa propre classe comme qualificateur (ce qui est redondant mais 
autorise). 

Erreurdu compilateur 
Erreur du compilateur 



If statement missing ( 

Parenthese gauche manquante apres le mot cle if dans une instruction if. 

If statement missing ) 

Parenthese droite manquante apres I'expression test dans une instruction if. 

If statement too long 
Ifdef statement too long 

If ndef statement too long 

Une instruction If, Ifdef ou Ifndef comporte plus de 4096 caracteres. 



Erreur de MAKE 
Erreur de MAKE 
Erreur de MAKE 
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gnored module, path is too long Mise en garde du bibliothecaire 

La longueur du chemin d'acces a un fichier .OBJ ou .LIB est superieure a 64 caracteres. Le bibliothecaire reconnait 
uniquement des chemins de longueur inferieure ou egale a 64 caracteres. 

Ilegal ACBP byte in SEGDEF in module module Erreur de I'editeur de liens 

Ce message indique generalement une erreur de convertisseur. 

Ilegal character caractere (Oxra/ue) Erreur du compilateur 

Le compilateur a detecte un caractere incorrect dans le fichier d'entree. La valeur hexadecimale du caractere incorrect est 

affichee. Cette erreur se produit egalement lorsque des parametres supplemental sont passes a une macro de fonction. 

Ilegal character in constant expression expression Erreur de MAKE 

MAKE a detecte un caractere non autorise dans une expression constante. Si le caractere est une lettre, ce message 
indique probablement un identificateur mal orthographie. 

Ilegal component to GRPDEF in module module Erreur de I'editeur de liens 

Ce message indique generalement une erreur de convertisseur. 

Ilegal group definition : groupe in module module Erreur de I'editeur de liens 

Cette erreur est due a un enregistrement GRPDEF mal forme dans un fichier .OBJ (fichier .OBJ cree par I'utilisateur ou 
presence d'un bug dans le convertisseur utilise pour generer le fichier .OBJ). Si ce message s'affiche dans un fichier cree par 
Borland C++, recompilez le fichier. Si le probleme persiste, contactez votre support technique Borland. 

Ilegal initialization Erreur du compilateur 

En C, une initialisation doit etre une expression constante ou I'adresse d'une variable globale externe ou statique a laquelle 
une constante peut etre ajoutee ou soustraite. Erreur de MAKE 

Ilegal octal digit Erreur du compilateur 

Le chiffre 8 ou 9 a ete detecte dans une constante octale. 

Ilegal parameter to _@hsp(0.2)_emit_@hsp(0.2)_ Erreur du compilateur 

L'argument passe a _@hsp(0.2)_emit_@hsp(0.2)_ n'est ni une constante ni une adresse. 

Ilegal pointer subtraction Erreur du compilateur 

Impossible de soustraire un pointeur a un non-pointeur. 

Ilegal structure operation Erreur du compilateur 

En C ou C++, une structure peut etre utilisee avec les operateurs d'acces (.), d'adressage (&) ou d'affectation (=) ou passee 
a partir ou a destination d'une fonction en tant que parametre. En C ou C++, une structure peut egalement etre utilisee avec 
des operateurs surcharges. Le compilateur a detecte une structure utilisee avec un operateur non autorise. 

Ilegal to take address of bit field Erreur du compilateur 

II est impossible de recuperer I'adresse d'un champ de bits bien qu'il soit possible de recuperer I'adresse d'autres types de 
champs. 

Ilegal type of entry point Erreur de I'editeur de liens 

Seuls les points d'entree qui ciblent un indice de segment sont reconnus. 

Ilegal use of floating point Erreur du compilateur 

Les operandes en virgule flottante ne sont pas autorises avec les operateurs de decalage, les operateurs booleens bit a bit, 
les operateurs d'indirection (*) ou certains autres operateurs. Le compilateur a detecte un operande en virgule flottante avec 
un operateur non autorise. 
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Illegal use of member pointer Erreurdu compilateur 

Un pointeur vers un membre de classe peut uniquement etre utilise avec les operateurs d'affection, de comparaison et les 
operateurs .*, ■>*, ?:, && et || ou passes comme argument a une fonction. Le compilateur a detecte un pointeur de membre 
utilise avec un operateur non autorise. 

Illegal use of pointer Erreur du compilateur 

Un pointeur peut etre utilise avec les operateurs d'addition, de soustraction, d'affectation, de comparaison, d'indirection (*) ou 
I'operateur fleche (■>). Un pointeur a ete utilise avec un operateur non autorise dans le fichier source. 

Ill-formed pragma Mise en garde du compilateur 

Erreur dans la directive de compilation pragma specifiee. Le compilateur Borland C++ ne reconnait pas cette directive. 

Image base address must be a multiple of 0x10000 Erreur de I'editeurde liens 

L'adresse de base d'une image de base doit etre un multiple de 0x10000. 

Implicit conversion of type 1 to type2 not allowed Erreur du compilateur 

Si une fonction membre d'une classe est appelee a I'aide d'un pointeur vers une classe derivee, la valeur de ce pointeur doit 
etre convertie implicitement pour pointer ver sla clase de basse appropriee. Ce message indique qu'une telle conversion 
implicite n'est pas autorisee. 

Import record does not match previous definition Mise en garde de I'editeur de liens 

Ce message s'affiche generalement si un enregistrement IMPDEF apparait dans une bibliotheque d'importation en meme 
temps que I'import en question est importe a partir d'un fichier .DEF. Si le nom interne et le numero ordinal des imports sont 
differents dans leur description, ce message s'affiche et la premiere definition est utilisee. L'affichage de ce message peut 
etre controle avec I'option -w. 

Improper use of ty pedef identificateur Erreur du compilateur 

Un symbole typedef a ete utilise la ou une variable aurait du etre specifiee dans une expression. Verifiez la declaration du 
symbole et corrigez les erreurs d'orthographe eventuelles. 

Include files nested too deep Erreurdu compilateur 

Lorsque le compilateur detecte plus de 1 000 niveaux d'imbrication de fichiers d'en-tete, il suppose que le fichier d'en-tete est 
recursif et arrete la compilation en generant ce message d'erreur fatale. 

nom_fichier{num_ligne): incompatible attribute Erreur de I'editeurde liens 

L'editeur de liens a detecte des attributs de segment incompatibles dans une instruction CODE ou DATA. Par exemple, 
PRELOAD et LOADONCALL ne peuvent pas etre les attributs du meme segment. 

Incompatible type conversion Erreur du compilateur 

Transtypage impossible. Verifiez les types. 

Incorrect command-line argument: argument Erreur de MAKE 

Specification d'arguments incorrects dans la ligne de commande. 

Incorrect command-line option: option Erreurdu compilateur 

Le parametre indique dans la ligne de commande n'a pas ete reconnu comme parametre autorise. 

Incorrect configuration file option: option Erreurdu compilateur 

Le parametre de fichier de configuration n'a pas ete reconnu comme parametre autorise. Verifiez qu'il est precede d'un trait 
d'union (SYMBOL -). 
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Incorrect number format Erreur du compilateur 

Le compilateur a detecte un separateur decimal dans un nombre hexadecimal. 

Incorrect use of default Erreur du compilateur 

Signe deux-points (:) manquant apres le mot cle default dans une instruction case. 

Incorrect version of RLINK32.DLL 

Une version incorrecte du fichier RLINK32.DLL a ete utilisee. Verifiez que vous disposez de la version correcte de cette 
bibliotheque DLL. 

Initializing enumeration with type Mise en garde du compilateur 

Tentative d'initialisation d'une variable enum avec un autre type. Par exemple : 

enum count { zero, one, two } x = 2; 

Cette initialisation genere ce message car 2 est de type int et non de type enum count. Pour un meilleur style de 
programmation, il est recommande d'utiliser un identificateur enum au lieu d'un entier litteral lorsque vous affectez ou 
initialisez des types enum. 

Bien qu'il s'agisse d'une erreur, ce message a valeur de mise en garde pour que le programme puisse quand meme 
s'executer. 

Inline assembly not allowed Erreur du compilateur 

Vous essayez de compiler a partir de I'environnement integre un fichier source contenant des instructions en assembleur en 
ligne. Vous devez utilisez BCC pour compiler ce type de fichier. 

Inline assembly not allowed in inline and template functions Erreur du compilateur 

Le compilateur ne peut pas traiter des instructions en assembleur en ligne dans une fonction inline ou template en C++. Vous 
pouvez supprimer le code en assembleur inline ou, en cas de fonction inline, la convertir en macro-instruction, ou encore 
supprimer la classe de stockage inline. 

int and string types compared Erreur de MAKE 

Vous avez essaye de comparer un operande de type entier et un operande de type chaine dans une expression !if ou lelif. 

Internal error - chaine Erreur de I'editeur de liens 

Cette erreur se produit tres rarement. Notez le texte du message et contactez votre support technique Borland. 

Internal Erreur de I'editeur de liens code_erreur Erreur de I'editeur de liens 

Erreur de logique interne de I'editeur de liens TLINK. Cette erreur ne devrait pas se produire en pratique mais elle est 
repertoriee ici au cas ou une erreur plus specifique serait generee. Si le probleme persiste, notez le numero code_erreur et 
contactez votre support technique Borland. 

Invalid combination of opcode and operands Erreur du compilateur 

L'assembleur integre n'autorise pas cette combinaison d'operandes. Les causes possibles sont les suivantes : 

■ Trop ou pas assez d'operandes pour ce code operation en assembleur. 

■ Le nombre d'operandes est correct mais leur type ou leur ordre ne correspond pas au code operation. Par exemple, 
DEC 1 , MOV AX ou MOV 1 ,AX. Essayez de faire preceder les operandes d'instructions de remplacement de type (par 
exemple, MOV AX.WORD PTR toto). 

Invalid entry point offset Erreur de I'editeur de liens 

Ce message s'affiche uniquement lorsque des modules comportant des enregistrements 32 bits font I'objet d'une edition de 
liens. II indique que le decalage initial du point d'entree du programme depasse la limite des 64 ko imposee par DOS. 
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Invalid indirection Erreur du compilateur 

L'operateur d'indirection (*) requiert un operande de type pointeur non void. 

Invalid initial stack offset Erreur de I'editeur de liens 

Ce message s'affiche uniquement lorsque des modules comportant des enregistrements 32 bits font I'objet d'une edition de 
liens. II indique que la valeur initiale du pointeur de pile depasse la limite des 64 ko imposee par DOS. 

Invalid macro argument separator Erreur du compilateur 

Dans une definition de macro-instruction, les arguments doivent etre separes par une virgule. Le compilateur a detecte un 
separateur different apres un nom d'argument. 

Invalid page size value ignored Mise en garde du bibliothecaire 

Taille de page incorrecte. La taille de page doit correspondre a une puissance de 2 et etre comprise entre 16 et 32 768. 

Invalid pointer addition Erreur du compilateur 

Impossible d'additionner deux pointeurs. 

Invalid register combination (e.g. [BP+BX]) Erreur du compilateur 

L'assembleur integre a detecte une combinaison illegale de registres dans une instruction. Seules sont autorisees les 
combinaisons de registres d'indices suivantes : [BX],[BP], [SI], [Dl], [BX+SI], [BX+DI], [BP+SI] et [BP+DI]. les combinaisons 
[AX], [BP+BX] et [SI+DX] sont illicites. 

Les variables locales (variables declarees dans des procedures et des fonctions) sont generalement allouees sur la pile et 
accessibles a partir d'un registre BP. L'assembleur ajoute automatiquement [BP] a ce type de variables dans des references. 
Par consequent, meme si une construction comme Local[EBX] (ou Local est une variable locale) semble correcte, elle ne 
Test en fait pas car I'operande final equivaudrait a Local[BP+EBX]. 

Invalid segment definition in module module Erreur de I'editeur de liens 

Le compilateur a genere un fichier objet defectueux. Si cela se produit dans un fichier cree avec Borland C++, recompilez le 
fichier. Si le probleme persiste, contactez votre support technique Borland. 

Invalid template argument list Erreur du compilateur 

Dans une declaration de template, le mot cle template doit etre suivi d'une liste d'arguments formels specifiee entre les 
delimiteurs < et >. La liste d'arguments specifiee n'est pas autorisee. 

Invalid template qualified name remp/afe.vnom Erreur du compilateur 

Dans la definition d'un membre de classe template, les arguments du nom de classe template utilise comme operande 
gauche de l'operateur :: doivent correspondre aux arguments formels de la classe template. Par exemple : 

template <class T> class X 
{ 

void f ( ) ; 



template <class T> void X<T>::f(){} 

La declaration suivante serait illicite : 

template <class T> void X<int> : : f () { } 

Invalid use of dot Erreur du compilateur 

Un operateur point (.) doit etre immediatement suivi d'un identificateur. 
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Invalid use of template template Erreur du compilateur 

En dehors de la definition d'un template, il est impossible d'utiliser un nom de classe template sans specifier ses arguments. 
Par exemple, vous pouvez utiliser vector<int> mais pas vector. 

Irreducible expression tree Erreur du compilateur 

Indique une forme d'Erreur du compilateur. Une expression sur la ligne indiquee dans le fichier source a empeche la 
generation de code par le generateur de code. Corrigez I'expression. Si I'erreur se produit a nouveau, contactez votre support 
technique Borland. 

base is an indirect virtual base class of classe Erreur du compilateur 

Impossible de creer un pointeur vers un membre C++ d'une classe de base virtuelle donnee. La tentative de creation de 
pointeur a ete effectuee (soit directement soit par transtypage). 

Identificateur is assigned a value that is never used Mlse en garde du compilateur 

La variable apparait dans une affectation mais n'est utilisee nulle part ailleurs dans la fonction dont le traitement vient de se 
terminer. Le message s'affiche uniquement lorsque le compilateur detecte I'accolade fermante. 

identificateur is declared as both external and static Mlse en garde du compilateur 

L'identificateur indique apparait a la fois dans une declaration qui I'a implicitement ou explicitement marque comme global ou 
externe et dans une declaration statique. L'identificateur est finalement interprete comme statique. Revoyez toutes les 
declarations de cet identificateur. 

identificateur is declared but never used Mise en garde du compilateur 

La variable specifiee a ete declaree dans le bloc dont le traitement vient de se terminer mais n'a jamais ete utilisee. Le 
message s'affiche lorsque le compilateur detecte I'accolade fermante d'une instruction ou d'une focntion composee. La 
declaration de la variable est effectuee au debut de I'instruction ou de la fonction composee. 

symbole is duplicated in module module Erreur de I'editeur de liens 

Conflit entre deux symboles (declares comme "public" ou "communal") definis dans le meme module. L'erreur se produit si 
les deux symboles sont detectes dans un fichier .OBJ. Un message de mise en garde s'affiche si TLINK detecte les deux 
symboles dans une bibliotheque. Dans ce cas, TLINK utilise la premiere definition. 

constructeur is not a base class of classe Erreur du compilateur 

Un constructeur de classe C++ classe tente d'appeler un constructeur de classe de base constructeur ou vous essayez de 
modifier les droits d'acces de classe : : constructeur. constructeur n'est pas une classe de base de classe. 
Verifiez les declarations correspondantes. 

identificateur is not a member of structure Erreur du compilateur 

Vous essayez de faire reference a identificateur en tant que membre de structure alors qu'il ne s'agit pas d'un membre. 
Verifiez les declarations correspondantes. 

identificateur \s not a non-static data member and can't be initialized here Erreur du compilateur 

Seules les donnees membres peuvent etre initialisees dans un constructeur. Le message indique que la liste comporte un 
membre statique ou un membre de fonction. 

identificateur is not a parameter Erreur du compilateur 

Dans la section de declaration des parametres d'une fonction "ancien style", l'identificateur indique est declare mais ne fait 
pas partie de la liste des parametres. Supprimez la declaration ou ajoutez identificateur en tant que parametre. 
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type is not a polymorphic class type Erreur du compilateur 

Un dynamic_cast a ete utilise avec un pointeur vers une classe qui a ete compilee avec I'option de compilateur -RT 
desactivee. 

identificateur is not a public base class of type_classe Erreur du compilateur 

L'operande droit d'un operateur .*, ->* ou :: n'est pas un pointeur vers un membre d'une classe. II doit correspondre a une 
classe de base accessible du type de la classe de l'operande gauche. 

nomjichier is not a valid library Mise en garde de I'editeur de liens 

Cette erreur se produit si un fichier qui n'etait pas une module de bibliotheque correct a ete passe a I'editeur de liens dans la 
section de bibliotheque. 

membre is not accessible Erreur du compilateur 

Vous essayez de faire reference au membre de classe C++ membre mais celui-ci est prive ou protege et ne peut etre 
reference a partir de cette fonction. Ce cas peut se produire lorsque vous tentez d'appeler une fonction membre (ou un 
constructeur) surcharged et accessible mais que les arguments correspondent a une fonction inaccessible. La verification de 
la resolution de surcharge est systematiquement effectuee avant la verification d'accessibilite. S'il s'agit de ce probleme, 
essayez un transtypage explicite d'un ou de plusieurs parametres pour selectionner la fonction accessible requise. 

Last parameter of operateur must have type i nt Erreur du compilateur 

Lorsqu'un operateur de post-incrementation ++ ou de post-decrementation - - est delare, le dernier parametre doit etre 
declare avec le type int. 

Library contains COMDEF records ■ extended dictionary not created Mise en garde du bibliothecaire 

Un enregistrement objet ajoute a une bibliotheque contient un enregistrement COMDEF. Ceci n'est pas compatible avec 
I'option de creation de dictionnaire etendu. 

Library too large, restart with library page size taille Erreur du bibliothecaire 

La bibliotheque creee n'a pas pu etre construite en tenant compte de la taille de page de bibliotheque en cours. 

Linkage specification not allowed Erreur du compilateur 

Les specifications d'edition de liens comme extern "C" sont autorisees uniquement au niveau du fichier. Deplacez cette 
declaration de fonction en dehors du niveau de fichier. 

Linker name conflict for fonction Erreur du compilateur 

Ce message est genere par le compilateur lorsque le nom d'une fonction inline ou d'une table virtuelle C++ tronquee pour 
depassement de longueur correspond au nom de la fonction ou de la table virtuelle qui a ete generee precedemment (ce 
probleme se pose souvent avec des templates). Modifiez le nom de la classe ou de la fonction ou utilisez I'option de 
compilation -Vs. 

Linker stack overflow Erreur de I'editeur de liens 

L'editeur de liens utilise une procedure recursive pour marquer les modules a inclure dans une image executable a partir de 
bibliotheques. Cette procedure peut entramer des debordements de pile dans des circonstances extremes. Si ce message 
s'affiche, supprimez certains modules des bibliotheques et incluez-les avec les fichiers objet dans I'edition de liens. Effectuez 
une nouvelle tentative. 

Lvalue required Erreur du compilateur 

La partie gauche d'un operateur d'affectation doit correspondre a une expression adressable comme une variable numerique 
ou une variable pointeur, une reference de champ de structure, une indirection via pointeur ou un element de tableau indice. 
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Macro argument syntax error Erreur du compilateur 

La definition d'une macro doit comporter un identificateur comme parametre. Un caractere ne correspondant pas a un 
specificateur a ete detecte a la place de I'argument. 

Macro expansion too long Erreur du compilateur 

Le developpement d'une macro-instruction ne doit pas depasser 4096 caracteres. 

Macro expansion too long Erreur de MAKE 

Le developpement d'une macro-instruction ne doit pas depasser 4096 caracteres. Cette erreur se produit souvent si une 
macro-instruction se developpe de fagon recursive (operation illicite). 

Macro substitute text chaine is too long Erreur de MAKE 

Macro replace text chaine is too long Erreur de MAKE 

Le texte chaine de substitution ou de remplacement de macro a fait deborder le tampon interne de MAKE (limite a 512 octets). 

main must have a return type of int Erreur du compilateur 

En C++, la fonction main doit obligatoirement etre declaree avec un type de valeur de renvoi int. 

Malformed command-line Erreur du compilateur 

Entree incorrecte dans la ligne de commande. 

Matching base class function for fonction has different dispatch number. Erreur du compilateur 

Si une fonction DDVT est declaree dans une classe derivee, la fonction de classe de base correspondante doit avoir le meme 
indice de distribution que la fonction derivee. 

Matching base class function for fonction is not dynamic Erreur du compilateur 

Si une fonction DDVT est declaree dans une classe derivee, la fonction de classe de base correspondante doit egalement 
etre dynamique. 

Maximum precision used for member pointer type type Mise en garde du compilateur 

Lorsqu'un type de pointeur de membre est declare, sa classe n'a pas ete completement definie, et I'option -Vmd a ete 
utilisee. Le compilateur doit alors utiliser la representation la plus generate (et done la moins efficace) de ce type de pointeur 
de membre. Le code genere peut s'averer moins performant (le type de pointeur de membre etant trap grand) et certains 
problemes peuvent se produire lors d'une compilation separee. 

Member function must be called or its address taken Erreur du compilateur 

Lorsqu'une fonction membre est utilisee dans une expression, elle doit etre appelee ou son adresse recuperee avec 
I'operateur &. La fonction membre en question est utilisee dans un contexte non autorise. 

Member identifier expected Erreur du compilateur 

Norn de structure ou de membre de classe C++ manquant. La partie droite d'un operateur point (.) ou fleche (■>) doit 
correspondre a un nom de membre dans la structure ou la classe specifiee a gauche de I'operateur. 

Member is ambiguous: membrel et membre2 Erreur du compilateur 

Vous devez qualifier la reference de membre avec le nom de classe de base appropriee. Dans une classe classe C++, un 
member membre peut figurer dans plusieurs classes de base. Le message signale qu'il n'a pas ete qualifie pour indiquer a 
quelle classe de base il appartenait reellement. Ce probleme survient uniquement en cas d'heritage multiple, lorsque le nom 
de membre dans chaque classe de base n'est pas occulte par le meme nom de membre dans une classe derivee sur le 
meme chemin d'acces. En C++, le test de detection d'ambiguite doit etre effectue avant la verification des droits d'acces 
(private, protected, public). II est done possible que ce message s'affiche meme si un seul des membres (ou aucun d'entre 
eux) est accessible. 
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Member membre cannot be used without an object Erreur du compilateur 

Vous avez specifies classe: : membre ou membre est de type ordinaire (non statique) mais aucune classe ne peut etre 
associee a ce membre. Parexemple, il est possible d'ecrire obj .classe: : membre mais classe: : membre n'est 
pas autorise. 

Member membre has the same name as its class Erreur du compilateur 

Le nom d'une donnee membre statique, d'un enumerates, d'un membre d'union anonyme ou d'un type imbrique doit etre 
different de celui de sa classe respective. Seul une fonction membre ou un membre non statique peut avoir le meme nom que 
sa classe. 

Member membre is initialized more than once Erreur du compilateur 

Dans un constructeur de classe C++, la liste des initialisations apres I'en-tete du constructeur comporte plusieurs occurrences 
d'un nom de membre. 

Member pointer required on right side of .* or ->* Erreur du compilateur 

La partie droite d'un operateur point-etoile (.*) ou fleche-etoile (■>*) doit etre declaree comme pointeur vers un membre de la 
classe specifiee a gauche de I'operateur. Ce message indique que la partie droite ne correspond pas a un pointeur de 
membre. 

Memory full listing truncated! Mise en garde du bibliothecaire 

Memoire insuffisante pour le bibliothecaire qui ne peut creer qu'un fichier de listage de bibliotheque incomplet. 

Memory reference expected Erreur du compilateur 

Reference de memoire requise par I'assembleur integre. Verifiez que vous avez specifie les operandes de registres d'indice 
entre crochets (par exemple, MOV AX,[BX+SI] et non MOV AX,BX+SI). 

Misplaced break Erreur du compilateur 

Le compilateur a detecte une instruction break en dehors d'une construction switch ou d'une boucle de repetition. 

Misplaced continue Erreur du compilateur 

Le compilateur a detecte une instruction continue en dehors d'une boucle de repetition. 

Misplaced decimal point Erreur du compilateur 

Le compilateur a detecte un separates decimal dans la partie exposant d'une constante en virgule flottante. 

Misplaced elif directive Erreur du compilateur 

Une directive #elif a ete specifiee sans directive #if, #ifdef ou #ifndef correspondante. 

Misplaced elif statement Erreur de MAKE 

Une directive !elif a ete specifiee sans directive !if correspondante. 

Misplaced else Erreur du compilateur 

Une instruction else a ete specifiee sans instruction if correspondante. Ce message peut indiquer la presence d'un instruction 
else ou d'un point-virgule ajoute par erreur, une erreur d'accolade ou une erreur de syntaxe dans une instruction if 
precedente. 

Misplaced else directive Erreur du compilateur 

Une directive #else a ete specifiee sans directive #if, #ifdef ou #ifndef correspondante. 

Misplaced else statement Erreur de MAKE 

Une directive !else a ete specifiee sans directive !if correspondante. 
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Misplaced endif directive Erreur du compilateur 

Une directive #endif a ete specifiee sans directive #if, #ifdef ou #ifndef correspondante. 

Misplaced endif statement Erreur de MAKE 

Une directive lendif a ete specifiee sans directive !if correspondante. 

nomjichier(numjigne): missing internal name Erreur de I'editeur de liens 

Dans la section IMPORTS du fichier de definition du module, une reference a une entree a ete specifiee a I'aide d'un nom de 
module et d'un nombre ordinal. Lorsqu'une entree est specifiee par un numero ordinal, un nom interne doit etre affecte a la 
definition de cet import. Ce nom interne est utilise par le programme pour faire reference a la definition importee. La definition 
du module doit avoir la syntaxe suivante : 

<nom_interne>=<nom_module> . <ordinal> 

Mixed common types in module module. Cannot mix COMDEFs and VIRDEFs. Erreur de I'editeur de liens 

Impossible de melanger COMDEF et VIRDEF. Desactivez I'option -Fc pour arreter la generation de COMDEF ou activez 
I'option -Vs pour arreter la generation de VIRDEF. 

Mixing pointers to different 'char' types Mise en garde du compilateur 

Un pointeur de type signed char a ete converti en pointeur unsigned char (ou inversement) sans instruction de transtypage 
explicite. Au sens strict, cette operation est incorrecte mais n'a pas de consequences graves. 

Multiple base classes require explicit class names Erreur du compilateur 

Dans un constructeur de classe C++, chaque appel de constructeur de classe specifies dans I'en-tete de constructeur doit 
comporter le nom de la classe de base s'il existe plusieurs classes de base immediates. 

Multiple declaration for identificateur Erreur du compilateur 

Declaration multiple d'un meme identificateur. Cette erreur peut etre due a un conflit de declarations (par exemple, int 
a; double a; ), a une fonction declaree de deux fagons differentes, une etiquette repetee dans une meme fonction ou 
une declaration repetee autre qu'une fonction externe ou une variable simple (en C). 

Multiple entry points defined Erreur de I'editeur de liens 

Un seul point d'entree doit etre defini pour I'application. 

Multiple stack segments found. The most recent one will be used. Mise en garde de I'editeur de liens 

Ce message s'affiche lorsque deux segments de pile de noms differents sont definis dans les modules objets. Le code de 
demarrage definit un segment de pile pour I'application. L'affichage de ce message peut etre controle a I'aide de I'option -w. 

identificateur must be a member function Erreur du compilateur 

La plupart des fonctions d'operateurs C++ peuvent etre des membres de classe ou des fonctions non membres ordinaires. 
Certaines doivent imperativement etre des membres de classe comme les operateurs =, ->, () et les conversions de types. La 
fonction operateur en question doit etre une fonction membre. 

identificateur must be a member function or have a parameter of class type Erreur du compilateur 

La plupart des fonctions d'operateur C++ doivent avoir un parametre de type classe implicite ou explicite. Cette fonction 
d'operateur a ete declaree en dehors d'une classe et n'a pas de parametre explicite de type classe. 

identificateur must be a previously defined class or struct Erreurdu compilateur 

Vous essayez de declarer identificateur comme une classe de base, identificateur n'est pas une classe ou n'a pas ete 
completement defini. Corrigez le nom ou modifiez les declarations. 
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identificateur must be a previously defined enumeration tag Erreurdu compilateur 

Cette declaration essaie de faire reference a identificateur en tant qu'indicateur de type enum. Corrigez le nom ou modifiez 
les declarations. 

identificateur must be declared with no parameters Erreur du compilateur 

Declaration incorrecte de cette fonction d'operateur C++ qui n'accepte aucun parametre. 

identificateur must be declared with one parameter Erreur du compilateur 

Declaration incorrecte de cette fonction d'operateur C++ qui accepte plusieurs parametres. 

operateur must be declared with one or no parameters Erreur du compilateur 

Lorsque I'operateur ++ ou - - est declare en tant que fonction membre, il doit etre declare comme n'acceptant aucun 
parametre (pour la version prefixee de I'operateur) ou comme acceptant un parametre de type int (pour la version suffixee de 
I'operateur). 

operateur must be declared with one or two parameters Erreur du compilateur 

Lorsque I'operateur ++ ou - - est declare comme une fonction non membre, il doit etre declare comme acceptant un 
parametre (pour la version prefixee de I'operateur) ou deux parametres (pour la version suffixee de I'operateur). 

identificateur must be declared with two parameters Erreur du compilateur 

Declaration incorrecte de cette fonction d'operateur C++ qui accepte uniquement deux parametres. 

Must take address of a memory location Erreur du compilateur 

Un operateur d'adressage (&) a ete utilise avec une expression illicite (une variable registre en C, par exemple). 

Need an identifier to declare Erreur du compilateur 

La declaration doit etre completee par un identificateur dans ce contexte. II peut s'agir d'un typedef sans nom ou d'un 
point-virgule supplemental au niveau du fichier. En C++, cette erreur peut etre due a un nom de classe utilise 
incorrectement pour un autre type d'identificateur. 

No : following the ? Erreurdu compilateur 

Signe deux-points (:) manquant apres le point d'interrogation (?) dans I'expression ou parentheses manquantes ou 
incorrectement imbriquees. 

No base class to initialize Erreur du compilateur 

Ce constructeur de classe C++ essaie d'appeler implicitement un constructeur de classe de base mais la classe en question 
a ete declaree sans classes de base. Verifiez les declarations. 

No closi ng quote Erreur de MAKE 

Apostrophe fermante manquante dans une expression chaine d'une instruction !if ou lelif. 

No declaration for function fonction Mise en garde du compilateur 

Un fonction a ete appelee avant d'avoir ete declaree. En C, une fonction peut etre declaree sans prototype (par exemple, 
int f une ( ) ; ). En C++, la declaration d'une fonction correspond egalement a son prototype. Ainsi, I'exemple precedent 
equivaut a int f une (void) ; . Cette declaration peut etre de style classique (sans prototype) ou moderne (avec 
prototype). 

No .DEF file; using defaults Mise en garde de I'editeur de liens 

Aucun fichier .DEF n'a ete specifie pour I'edition de liens. L'option -w permet de controler I'affichage de ce message. 

No file name ending Erreur du compilateur 

Apostrophe ou parenthese angulaire fermante manquante apres le nom de fichier specifie dans une directive #include. 
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No filename ending Erreur de MAKE 

Apostrophe ou parenthese angulaire fermante manquante apres le nom de fichier specifie dans une instruction linclude. 

No file names given Erreur du compilateur 

Aucun nom de fichier specifie dans la ligne de commande du compilateur Borland C++. Specifiez un fichier source. 

No internal name for IMPORT in .DEF file 

Erreur semantique dans le fichier .DEF : nom interne d'import manquant avant le nom de module. Par exemple : 

IMPORTS 

_toto . 1 

Dans cet exemple, Joto est suppose designer la fonction a importer mais la syntaxe correcte est la suivante : 

IMPORTS 

_toto=mydll . 1 

No macro before = Erreur de MAKE 

Vous devez attribuer un nom a une macro-instruction avant de pouvoir lui affecter a une valeur. 

No match found for wildcard expression Erreur de MAKE 

Aucun fichier ne correspond a la specification utilisant des caracteres de remplacement et ne peut done etre traite par MAKE. 
Par exemple, si vous codez 

prog.exe: *.obj 

MAKE envoie ce message d'erreur si aucun fichier avec I'extension .OBJ ne figure dans le repertoire en cours. 

No output file specified Erreur de I'editeur de liens 

Aucun fichier .EXE ou .DLL n'a ete specifie. Dans la mesure ou I'editeur de liens utilise par defaut le premier nom avec 
I'extension .OBJ, cette erreur a generalement pour origine I'absence de fichiers objet. 

No program entry point Mise en garde de I'editeur de liens 

Ce message s'affiche si aucun point d'entree d'execution n'a ete defini pour I'application. Cette erreur se produit si vous 
oubliez d'effectuer I'edition de liens du code de demarrage. L'affichage de ce message peut etre controle a I'aide de I'option 
-w. 

No program starting address defined Mise en garde de I'editeur de liens 

Ce message indique qu'aucun module n'a ete defini dans I'adresse de depart initiale du programme. Ceci est problement du 
a un defaut d'edition de liens du module d'initialisation COx.OBJ. 

No stack Mise en garde de I'editeur de liens 

Ce message s'affiche si aucun segment de pile n'a ete defini dans I'un des fichiers objet ou I'une des bibliotheques inclus 
dans I'edition de liens. Ce message est normal pour le modele de memoire "tiny" en Borland C++ ou pour tout programme 
d'application qui doit etre converti en fichier .COM. Ce message indique une erreur sauf pour les fichiers de bibliotheque DLL. 

Si un programme Borland C++ genere ce message pour un modele de memoire autre que le modele "tiny", verifiez que vous 
utilisez les fichiers objet de demarrage COx appropries. 

No stub for fixup at segmenkxxxxh in module module Mise en garde de I'editeur de liens 

Cette erreur se produit lorsque la cible d'une reference se trouve dans un segment de recouvrement mais qu'aucun "stub" 
n'est disponible pour une cible externe. Ceci est du au fait de restreindre I'acces a un symbole dans un recouvrement qui est 
reference a partirdu meme module. 
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No terminator specified for in-line file operator Erreurde MAKE 

Le fichier MAKE contient les operateurs && ou « pour debuter un fichier en ligne, mais la fin de ce fichier n'est pas marquee. 

Non-const function fonction called for const object Mise en garde du compilateur 

Une fonction membre non constante a ete appelee pour un objet de type const. Bien qu'il s'agisse d'une erreur, ce message 
a valeur de mise en garde pour que le programme puisse quand meme s'executer. 

Non portable pointer comparison Mise en garde du compilateur 

Le fichier source comporte une comparasion entre un pointeur vers un non-pointeur autre que la constante nulle. Utilisez un 
transtypage pour supprimer ce message si la comparaison est correcte. 

Nonportable pointer conversion Erreur du compilateur 

Une conversion implicite entre un pointeur et un type entier est requise mais les types n'ont pas la meme taille. Cette 
operation ne peut pas etre effectuee sans transtypage explicite. Verifiez la logique et le resultat de cette conversion. 

Non portable pointer conversion Mise en garde du compilateur 

Une valeur entiere non nulle est utilisee dans un contexte ou un pointeur ou une valeur entiere est requis. Le type entier et le 
pointeur ont la meme taille. Utilisez un transtypage explicite pour vous assurer de la logique et du resultat de I'operation. 

Non resident Name Table is greater than 64K Mise en garde de I'editeur de liens 

La taille maximale d'une table de noms NonResident est de 64 ko (selon les specifiactions en vigueur). L'editeur de liens 
poursuit son operation mais ne tient pas compte des autres noms NonResident detectes lors de I'edition de liens. 

Nontype template argument must be of scalar type Erreur du compilateur 

Un argument de template formel non type doit etre de type scalaire (type entier, enumeration ou pointeur). 

Non-ANSI Keyword Used : mot cle Erreur du compilateur 

Un mot cle non defini par la norme ANSI (comme_fastcall) a ete utilise alors que I'option -A stipulait I'utilisation d'un code 
en stride conformite avec cette norme. 

Non-virtual function fonction declared pure Erreur du compilateur 

Seule une fonction virtuelle peut etre declaree pure dans la mesure oil une classe derivee doit pouvoir la remplacer. 

Non-volatile function fonction called for volatile object Mise en garde du compilateur 

En C++, une fonction membre de classe a ete appelee pour un objet volatile de type classe, mais la fonction n'a pas ete 
declaree comme volatile apres I'en-tete de fonction. Seule une fonction volatile peut etre appelee pour un objet volatile. 

nomjichier not a MAKE Erreur de MAKE 

Le fichier specifie avec I'option -f n'est pas un fichier MAKE. 

Not an allowed type Erreur du compilateur 

Le fichier source contient une declaration d'un type non autorise. Par exemple, une fonction renvoyant une fonction ou un 
tableau. 

Not enough memory Erreur de MAKE 

La totalite de la memoire de travail a ete epuisee. 

Not enough memory Erreur de I'editeur de liens 

Memoire insuffisante pour executer TLINK. Essayez de reduire la taille d'un disque RAM ou d'un cache actif. Si vous etes en 
mode d'execution reel, essayez d'utiliser I'option MAKE -S ou de retirer des programmes en memoire residentes ou des 
gestionnaires de reseau. 
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Not enough memory for command-line buffer Erreurdu bibliothecaire 

Memoire insuffisante pour le bibliothecaire. 

module not found in library Mise en garde du bibliothecaire 

Tentative a ete faite d'executer une operation '_' ou '*' sur une bibliotheque mais I'objet specifie ne figure pas dans la 
bibliotheque. 

Null pointer assignment Erreur d'execution 

A la fin d'un programme (modele de memoire "small" ou "medium"), une verification est effectuee pour determiner si les 
premiers octets du segment de donnees du programme ont ete modifies. Ces octets ne doivent en principe jamais etre 
modifies par un programme en execution. S'ils ont ete modifies, le message CHAR 34 Null pointer assignmentCHAR 34 
s'affiche pour indiquer qu'une valeur a ete probablement stockee dans un pointeur non initialise. Meme si le programme peut 
sembler fonctionner normalement, il s'agit d'un bug important qui doit etre corrige rapidement. Si vous ne rectifiez pas ce 
pointeur non initialise, le programme peut reagir de fagon imprevisible et "bloquer" I'ordinateur dans les modeles de memoire 
"large", "compact" et "huge". Vous pouvez utiliser le debogueur integre pour rechercher des pointeurs NULL. 

Numeric constant too large Erreur du compilateur 

Impossible de generer une sequence d'echappement de type chaine ou caractere plus grande que \xFF (en hexadecimal) ou 
\377 (en octal). Un constante caractere sur deux octets peut etre specifiee a I'aide d'une deuxieme barre oblique inversee. 
Par exemple, \xOD\xOA represente une constante sur deux octets. Un litteral numerique apres une sequence d'echappement 
doit etre decompose comme suit : 

printf ("\xOD" "12345"); 

Cette instruction affiche un retour chariot suivi de 12345. 

Object module nomjichiens invalid Erreurdu bibliothecaire 

Le bibliothecaire n'a pas pu interprets I'enregistrement d'en-tete du module objet ajoute a la bibliotheque et a suppose que le 
module etait incorrect. 

Objects of type type cannot be initialized with {} Erreurdu compilateur 

Une structure C ordinaire peut etre initialisee a I'aide d'un groupe de valeurs entre accolades. Une classe C++ peut etre 
initialisee a I'aide de constructeurs si la classe definit des constructeurs, des membres prives, des fonctions ou des classes 
de base virtuelles. 

Old debug information in module module will be ignored Mise en garde de I'editeur de liens 

Incompatibilite des informations de debogage avec cette version de I'editeur de liens. Ces informations ne sont pas prises en 
compte. 

Only «KEEP or «NOKEEP Erreur de MAKE 

Vous avez specifie quelque chose d'autre apres KEEP ou NO KEEP lors de la fermeture d'un fichier inline temporaire. 

Only member functions may be 'const' or 'volatile' Erreurdu compilateur 

Seule une fonction membre de classe peut etre declaree const et/ou volatile. Toute declaration d'un autre element avec ces 
types est illicite. 

Only one of a set of overloaded functions can be "C" Erreur du compilateur 

Les fonctions C++ sont surchargees par defaut et le compilateur affecte un nouveau nom a chaque fonction. Pour remplacer 
ce nom en declarant la fonction externe "C", vous ne pouvez effectuer cette operation que pour un seul groupe de fonctions 
portant le meme nom. Autrement, I'editeur de liens detecterait plusieurs fonctions globales avec le meme nom. 
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Operand of delete must be non-const pointer Erreurdu compilateur 

Impossible de supprimer une valeur de pointeur constant avec l'operateur delete. 

Operator [ ] missing ] Erreur du compilateur 

L'operateur [ ] a ete declare comme operator [. Rajoutez le signe ] manquant ou modifiez la declaration. 

Operator -> must return a pointer or a class Erreur du compilateur 

L'operateur -> doit etre declare pour renvoyer une classe ou un pointeur vers une classe (ou une structure ou une union) a 

laquelle il est possible d'appliquer l'operateur ->. 

Operator delete must return void Erreur du compilateur 

Declaration incorrecte de l'operateur surcharge delete. Redeclarez-le pour qu'il renvoie une valeur void. 

Operator delete[ ] Must Return Void Erreur du compilateur 

Declaration incorrecte de l'operateur surcharge delete. Redeclarez-le comme suit : 

■ avec un parametre unique void* ; 

■ avec un second parametre de type sizej. 

Si vous utilisez la deuxieme syntaxe, elle sera utilisee de preference a la premiere. L'operateur global delete ne peut etre 
declare qu'avec le parametre void*. 

Operator must be declared as function Erreur du compilateur 

Declaration incorrecte d'un operateur surcharge. Declarez-le avec le type fonction. 

Operator new must have an initial parameter of type sizej Erreur du compilateur 

L'operateur new peut etre declare avec un nombre de parametres arbitraire. L'un de ces parametres doit imperativement 
specifier le volume d'espace a allouer. 

Operator new must return an object of type void * Erreur du compilateur 

Declaration incorrecte de l'operateur surcharge new. II doit imperativement renvoyer un objet de type void *. 

Operator new[] must have an initial parameter of type sizej Erreurdu compilateur 

L'operateur new peut etre declare avec un nombre de parametres arbitraire. L'un de ces parametres doit imperativement 
specifier le volume d'espace a allouer. 

Operator new[] must return an object of type void * Erreur du compilateur 

Declaration incorrecte de l'operateur surcharge new. 

Operators may not have default argument values Erreurdu compilateur 

Un operateur surcharge ne peut avoir de valeurs d'argument par defaut. 

Out of memory Erreur du compilateur 

La totalite de la memoire de travail est epuisee. Compilez le fichier sur une machine disposant de plus de memoire. 

Out of memory Erreur du bibliothecaire 

Pour un certain nombre de raisons, le bibliothecaire et Borland C++ ne disposent plus de memoire pour creer la bibliotheque. 
Dans des cas plus specifiques, un message plus detaille est affiche. Ce message s'affiche generalement pour indiquer une 
memoire insuffisante. 

Vous devez liberer de la memoire si ce message s'affiche parce que les tables de symboles publics sont devenues trap 
volumineuses. Vous devrez eventuellement retirer des programmes residents ou des pilotes de peripheriques utilisant la 
memoire en mode reel ou refermer certaines fenetres. Vous pouvez egalement liberer de la memoire dans I'EDI en quittant 
certains editeurs. 
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Out of memory Erreur de I'editeur de liens 

L'editeur de liens ne dispose plus de memoire allouee dynamiquement necessaire au processus d'edition de liens. Ce 
message indique une memoire insuffisante pour I'utilisation de TLINK due a un nombre trap eleve de modules, d'externes, de 
groupes ou de segments qui ont ete definis par les fichiers objets lies ensemble. Essayez de reduire la taille des disques 
RAM et/ou des caches actifs. 

Out of memory creating extended dictionary Erreur du bibliothecaire 

Memoire insuffisante pour que le bibliothecaire puisse creer un dictionnaire etendu pour une bibliotheque. La bibliotheque est 
creee mais ne dispose pas d'un tel dictionnaire. 

Out of memory for block bloc Erreur de I'editeur de liens 

Erreur rare. Notez le texte du message (ainsi que le nom du bloc) et contactez votre support technique Borland. 

Out of memory reading LE/LIDATA record from object module Erreur du bibliothecaire 

Le bibliothecaire essaie de lire un enregistrement de donnees a partir du module objet, mais il ne dispose pas d'un bloc de 
memoire assez volumineux. Pour resoudre ce probleme, vous pouvez essayer d'ajouter le module avant les autres modules 
si ce module a un ou plusieurs segments de donnees importants. Cette methode permet de disposer de davantage de 
memoire pour maintenir plus tard les listes de symboles publics et de modules. 

Out of space allocating per module debug struct Erreur du bibliothecaire 

Memoire insuffisante pour que le bibliothecaire alloue de I'espace aux informations de debogage associees a un module objet 
donne. Pour resoudre ce probleme, supprimez les informations de debogage de certains des modules a ajouter a la 
bibliotheque. 

Output device is full Erreur du bibliothecaire 

Ce message indique que le disque est pratiquement sature. 

Overlays generated and no overlay manager included Mise en garde de I'editeur de liens 

Ce message s'affiche en cas de creation de segments de recouvrement mais le symbole OVRTRAP_ n'est defini dans 

aucun des modules objet ou des bibliotheques inclus dans I'edition de liens. Ce symbole est defini dans la bibliotheque 
standard OVERLAY.LIB. 

Overlays only supported in medium, large, and huge memory models Erreur du compilateur 

Seuls les programmes utilisant les modeles de memoire "medium", "large" ou "huge" peuvent comporter des segments de 
recouvrement. 

Overload is now unnecessary and obsolete Mise en garde du compilateur 

Dans les versions precedentes de C++, le mot reserve overload servait a marquer les noms de fonctions surchargees. La 
version actuelle de C++ utilise une "edition de liens avec types fiabilises" qui suppose qu'une fonction est surcharged par 
defaut (sauf indication contraire). Ce message indique qu'il n'est plus necessaire d'utiliser overload. 

Overloadable operator expected Erreur du compilateur 

Pratiquement tous les operateurs C++ peuvent etre surcharges a I'exception des operateurs point selection de champ (.), 
point-etoile (.*), double deux-points (::) et I'expression conditionnelle (?:). Les operateurs de preprocesseur (# et ##) qui ne 
sont pas des operateurs en C et C++ et d'autres signes de ponctuation, comme le point-virgule, ne peuvent pas etre 
surcharges. 

Overloaded nomjonction ambiguous in this context Erreur du compilateur 

Un nom de fonction surcharged peut etre appele sans qu'il soit necessaire d'appeler la fonction uniquement si une variable ou 
un parametre de type approprie est initialise ou affecte. Ce message indique qu'un nom de fonction surcharged a ete utilise 
dans un autre contexte. 
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Overloaded prefix 'operator operateur' used as a postfix operator Mise en garde du compilateur 

Selon les specifications les plus recentes de C++, il est possible de surcharger les operateurs ++ et - - en version prefixee ou 
suffixee. Pour pouvoir compiler un code conforme a des specifications precedentes, dans le cas ou seul I'operateur (en 
version prefixee) est surcharge, mais utilise dans un contexte de suffixage, Borland C++ utilise I'operateur prefixe et genere 
ce message. 

P1 001 Unable to read file nomjichier Erreur du compilateur d'aide (projet) 

Le fichier specifie dans le fichier projet est illisible. Ce message indique une erreur de fichier DOS. 

P1003 Invalid path specified in Root option Erreur du compilateur d'aide (projet) 

Le fichier specifie avec I'option Root est introuvable. Le compilateur utilise le repertoire de travail en cours. 

P1005 Path and filename exceed limit of 79 characters Erreur du compilateur d'aide (projet) 

Le nom de chemin absolu ou du chemin relatif a partirdu repertoire racine comporte plus de 79 caracteres (limite imposee 
par DOS). Le fichier n'est pas pris en compte. 

P1007 Root path exceeds maximum limit of 66 characters Erreur du compilateur d'aide (projet) 

Le nom de chemin du repertoire racine comporte plus de 66 caracteres (limite imposee par DOS). Le nom de chemin n'est 
pas pris en compte et le compilateur utilise le repertoire de travail en cours. 

P1 009 [FILES] section missing Erreur du compilateur d'aide (projet) 

Section [Files] obligatoire. La compilation est abandonnee. 

P1 01 1 Option nom_option previously defined Erreur du compilateur d'aide (projet) 

L'option specifiee a deja ete definie. Le compilateur ne tient pas compte de cette tentative de redefinition. 

P1 01 3 Project file extension cannot be .H LP Erreur du compilateur d'aide (projet) 

Extension de fichier projet .HLP incorrecte. Un fichier projet doit normalement etre specifie avec I'extension .HPJ. 

P1015 Unexpected end-of-file Erreur du compilateur d'aide (projet) 

Erreur de fin de fichier. II peut s'agir d'un commentaire ouvert dans un fichier projet ou un fichier inclus. 

P1 01 7 Parameter exceeds maximum length of 1 28 characters Erreur du compilateur d'aide (projet) 

Une option, un nom ou un numero de contexte, un code de compilation conditionnelle ou un autre parametre dans la ligne 
indiquee comporte plus de 128 caracteres. Cette ligne n'est pas prise en compte. 

P1021 Context number already used in [MAP] section Erreur du compilateur d'aide (projet) 

Le numero de contexte dans la ligne indiquee dans le fichier projet a deja ete mise en correspondance avec une autre chaine 
contexte. Cette ligne n'est pas prise en compte. 

P1 023 Include statements nested too deeply Erreur du compilateur d'aide (projet) 

L'instruction #include de la ligne indiquee comporte plus de 5 niveaux d'inclusion. 

P1025 Section heading nom_section unrecognized Erreur du compilateur d'aide (projet) 

Utilisation d'un en-tete de section non reconnu par le compilateur. Cette ligne n'est pas prise en compte. 

P1027 Bracket missing from section heading nom_section Erreur du compilateur d'aide (projet) 

Crochet droit (]) manquant dans I'en-tete de la section specifiee. Corrigez le code est recompilez. 

P1 029 Section headi ng missi ng Erreur du compilateur d'aide (projet) 

En-tete de section incomplet a la ligne indiquee. Ce message s'affiche egalement si la premiere entree dans le fichier projet 
ne correspond pas a un en-tete de section. Le compilateur passe a la ligne suivante. 
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P1 030 Section nom_section previously defined Erreur du compilateur d'aide (projet) 

En-rite de section defini deux fois dans le fichier projet. Les lignes suivant le second en-tete ne sont pas prises en compte et 
le compilateur reprend au prochain en-tete de section correct. 

P1031 Maximum number of build tags exceeded Erreur du compilateur d'aide (projet) 

Vous pouvez definir un maximum de 30 codes de compilation conditionnelle. Les codes supplementaires ne sont pas pris en 
compte. 

P1033 Duplicate build tag in [BUILDTAGS] section Erreur du compilateur d'aide (projet) 

Duplication d'un code de compilation conditionnelle dans la section [BUILDTAGS]. 

P1035 Build tag length exceeds maximum Erreur du compilateur d'aide (projet) 

Le code de compilation conditionnelle a la ligne indiquee comporte plus de 32 caracteres (limite imposee). Cette ligne n'est 
pas prise en compte. 

P1037 Buildtag nomcode contains invalid characters Erreur du compilateur d'aide (projet) 

Un code de compilation conditionnelle peut uniquement comporter des caracteres alphanumeriques et le trait de 
soulignement (J. Cette ligne n'est pas prise en compte. 

P1039 [BUILDTAGS] section missing Erreur du compilateur d'aide (projet) 

L'option BUILD declare une compilation conditionnelle mais le fichier projet ne comporte pas de section [BuildTags]. Tous les 
ecrans d'aide sont incluse dans la compilation conditionnelle. 

P1043Too many tags in Build expression Erreur du compilateur d'aide (projet) 

L'expression Build a la ligne indiquee comporte plus de 20 codes de compilation conditionnelle (limite impossee). Cette ligne 
n'est pas prise en compte par le compilateur. 

P1 045 [ALIAS] section found after [MAP] section Erreur du compilateur d'aide (projet) 

La section [Alias] doit preceder la section [Map] dans un fichier projet. Si cet ordre n'est pas respecte, la section [Alias] n'est 
pas prise en compte. 

P1047 Context string nom_contexte already assigned an alias Erreur du compilateur d'aide (projet) 

Impossible d'enchainer les instructions du type a=b, puis a=c<_>. Une chaine contexte ne peut avoir qu'un seul alias. 

Un alias a deja ete defini a la section [Alias] pour la chaine contexte specifiee. Ce message indique que la tentative de 
reaffectation n'est pas prise en compte. 

P1049 Alias string aliasname already assigned Erreur du compilateur d'aide (projet) 

Impossible d'enchainer les instructions a=b et b=c. 

II est illicite d'affecter un autre alias a une chaine d'alias. 

P1051 Context string nom_contexte cannot be used as alias string Erreur du compilateur d'aide (projet) 

Impossible d'enchainer les instructions a=b et c=a. 

Une chaine contexte a laquelle un alias a ete affectee ne peut pas etre utilisee comme alias d'une autre chaine contexte. 

P1 053 Maximum number of font ranges exceeded Erreur du compilateur d'aide (projet) 

Cinq intervalles de corps de polices de caracteres peuvent etre specifies au maximum. Les intervalles supplementaires ne 
sont pas pris en compte. 

P1 055 Current font range overlaps previously defined range Erreur du compilateur d'aide (projet) 

Chevauchements d'un intervalle de taille de police de caarcteres et d'un autre intervalle deja defini. Adaptez I'un des 
intervalles afin de supprimer les chevauchements. Le second intervalle n'est pas pris en compte. 
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P1 056 Unrecognized font name in Forcefont option Erreur du compilateur d'aide (projet) 

Detection d'un nom de police de caracteres non reconnu par le compilateur. Cette police de caracteres n'est pas prise en 
compte et la police par defaut Helvetica est utilisee. 

P1 057 Font name too long Erreur du compilateur d'aide (projet) 

La longueur du nom de la police specifiee est superieure a 20 caracteres. Cette police n'est pas prise en compte. 

P1059 Invalid multiple-key syntax Erreur du compilateur d'aide (projet) 

Syntaxe utilisee avec I'option MULTIKEY non reconnue. 

P1 061 Character already used Erreur du compilateur d'aide (projet) 

L'identificateur de table de mots cles @char(177) specifie est deja utilise. Choisissez un autre caractere. 

P1063 Characters 'K' and 'k' cannot be used Erreur du compilateur d'aide (projet) 

Ces caracteres sont reserves a la table de mots cles primaire du systeme d'aide. Choisissez un autre caractere. 

P1 065 Maximum number of keyword tables exceeded Erreur du compilateur d'aide (projet) 

Cinq tables de mots cles peuvent etre specifies au maximum. Utilisez moins de tables. Les tables supplementaires ne sont 
pas prises en compte. 

P1 067 Equal sign missing Erreur du compilateur d'aide (projet) 

Signe egal (=) manquant pour I'option a la ligne indiquee. Verifiez la syntaxe de I'option. 

P1069 Context string missing Erreur du compilateur d'aide (projet) 

Chaine contexte manquante avant un signe egal (=) a la ligne indiquee. 

P1071 Incomplete line in nom_section section Erreur du compilateur d'aide (projet) 

Entree incomplete a la ligne indiquee. Cette ligne n'est pas prise en compte. 

P1073 Unrecognized option in [OPTIONS] section Erreur du compilateur d'aide (projet) 

Option specifiee non reconnue par le compilateur. La ligne n'est pas prise en compte. 

P1075 Invalid build expression Erreur du compilateur d'aide (projet) 

Erreur(s) de syntaxe ou de logique dans I'expression de compilation conditionnelle a la ligne indiquee. 

P1077 Warning level must be 1, 2, or 3 Erreur du compilateur d'aide (projet) 

Erreur de definition de I'option WARNING. Les valeurs possibles sont 1 , 2 ou 3. Le niveau par defaut fournissant un 
maximum d'informations (niveau 3) est utilise par le compilateur. 

P1 079 Invalid compression option Erreur du compilateur d'aide (projet) 

L'option COMPRESS peut uniquement etre definie a la valeur TRUE ou FALSE. La compilation se poursuit sans compilation. 

P1081 Invalid title string Erreur du compilateur d'aide (projet) 

L'option TITLE definit une chaine nulle ou qui contient plus de 32 caracteres. Le titre est tronque. 

P1 083 Invalid context identification number Erreur du compilateur d'aide (projet) 

Le numero de contexte a la ligne indiquee est nul ou contient des caracteres non autorises. 

P1 085 Unrecognized text Erreur du compilateur d'aide (projet) 

Le texte specifie apres le texte correct a la ligne indiquee est indechiffrable. La ligne n'est pas prise en compte. 

P1 086 Invalid font-range syntax Erreur du compilateur d'aide (projet) 

Erreur de syntaxe dans la definition d'un intervalle de corps de polices de caracteres. Cette ligne n'est pas prise en compte 
par le compilateur. Verifiez la syntaxe de l'option MAPFONTSIZE. 
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P1089 Unrecognized sort ordering Erreur du compilateur d'aide (projet) 

Ordre de tri non reconnu par le compilateur. Pour plus de details sur la signification de ce message, contactez votre support 
technique Borland. 

Parameter names are used only with a function body Erreur du compilateur 

Si vous declarez une fonction (ou si vous ne la definissez pas avec un corps de fonction), vous devez specifier des 
parentheses vides ou un prototype de fonction. Vous ne pouvez pas declarer une fonction uniquement avec une liste de 
noms de parametre. 

Voici des exemples de declaration : 

int f une ( ) ; // declaration sans prototype — OK 

int func(int, int); // declaration avec prototype — OK 

int func(int i, int j ) ; // noms de parametre dans prototype — OK 

int func(i, j ) ; // noms de parametre uniquement — illicite 

Parameter numero missing name Erreur du compilateur 

Dans un en-tete de definition de fonction, ce parametre comporte un specificateur de type numero sans nom de parametre. 
Bien qu'illicite en C, cette syntaxe est autorisee en C++ mais il n'existe aucun moyen de faire reference a ce parametre dans 
la fonction. 

Parameter parametre is never used Mise en garde du compilateur 

Le parametre specifie, declare dans la fonction, n'a jamais ete utilise dans le corps de la fonction. Cette erreur est souvent 
due a un parametre mal orthographie. Ce message s'affiche egalement si I'identificateur est redeclare comme une variable 
locale automatique dans le corps de la fonction. Le parametre est masque par la variable automatique et n'est toujours pas 
utilise. 

chemin - path is too long Erreur du bibliothecaire 

La longueur du chemin d'acces a un fichier de bibliotheque ou un fichier module est superieure a 64 caracteres. 

Pointer to structure required on left side of ■> or ->* Erreur du compilateur 

En C et C++, la partie gauche d'un operateur fleche (■>) doit imperativement etre un pointeur. En C++, I'operateur ->* est 
autorise. 

Possible reference to undefined extern xxxx:\ in module module Mise en garde de I'editeur de liens 

Une donnee membre statique a ete declaree mais non definie dans Implication. 

Possible unresolved external sym referenced from module mod Mise en garde de I'editeur de liens 

Ce message s'affiche uniquement si une donnee membre statique d'une classe a ete declaree mais non definie. 

Possible use of identificateur before definition Mise en garde du compilateur 

La variable indiquee est utilisee dans une expression avant qu'une valeur ne soit affectee. Le compilateur effectue une simple 
verification pour determiner cette condition. Ce message s'affiche si la variable est utilisee physiquement avant toute 
affectation. Le flux du programme peut evidemment affecter la valeur avant que le programme ne I'utilise. 
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Possibly incorrect assignment Mise en garde du compilateur 

Ce message s'affiche si le compilateur detecte un operateur d'affectation utilise comme operateur principal d'une expression 
conditionnelle (dans une instruction if, while ou do-while par exemple). II s'agit souvent d'une erreurtypographique de 
I'operateur d'egalite. Pour desactiver ce message, placez cette affectation entre parentheses et comparez I'expression ainsi 
formee a zero de fagon explicite. Soit le code : 

if (a = b) ... 

doit etre reecrit comme suit : 

if ( (a = b) != 0) ... 

Program entry point may not reside in an overlay Erreur de I'editeur de liens 

Bien que la majeure partie d'une application puisse etre recouverte, I'adresse de depart initiale ne peut se situer dans un 
segment de recouvrement. Ce message indique en general qu'une tentative de recouvrement du module d'initialisation 
COx.OBJ a ete faite a I'aide de I'option /o, par exemple, avant le module de demarrage. 

Public symbole'm module modulel clashes with prior module module2 Erreur du bibliothecaire 

Un symbole public ne peut apparaitre qu'une seule fois dans un fichier de bibliotheque. Un module ajoute a cette bibliotheque 
contient un symbole public qui existe deja dans un autre module. Ce message indique le nom du second module. 

Public symbole in module nomjichier clashes with prior module Erreur du bibliothecaire 

Un symbole public ne peut apparaitre qu'une seule fois dans un fichier de bibliotheque. Un module ajoute a cette bibliotheque 
contient un symbole public qui existe deja dans un autre module. 

Public symbol symbole defined in both module modi and mod2 Mise en garde de I'editeur de liens 

Ce message indique qu'un symbole public est defini dans deux fichiers .OBJ. Dans ce cas, le premier symbole public 
remplace le second symbole public. L'affichage de ce message peut etre controle a I'aide de I'option -wdup. 

R2001 Unable to open bitmap file nomjichier Erreur du compilateur d'aide (RTF) 

Impossible de lire le fichier bitmap specifie. II s'agit d'une erreur de fichier DOS. 

R2003 Unable to include bitmap file nomjichier Erreur du compilateur d'aide (RTF) 

Impossible de trouver ou de lire le fichier bitmap specifie. Ce message indique une erreur de fichier DOS ou une memoire 
insuffisante. 

R2005 Disk full Erreur du compilateur d'aide (RTF) 

Impossible d'ecrire le fichier ressource d'aide sur le disque. Liberez de I'espace sur I'unite de destination. 

R2009 Cannot use reserved DOS device name for file nomjichier Erreur du compilateur d'aide (RTF) 

Un fichier a ete designe comme etant COM1 , LPT2, PRN, etc. Renommez ce fichier. 

R2013 Output file nomjichier already exists as a directory Erreur du compilateur d'aide (RTF) 

Un repertoire sous la racine du fichier projet d'aide porte le meme nom que le fichier ressource d'aide requis. Deplacez ou 
renommez ce repertoire. 

R2015 Output file nomjichier already exists as read-only Erreur du compilateur d'aide (RTF) 

Le fichier specifie est accessible en lecture uniquement et ne peut etre remplace par le fichier ressource d'aide. Renommez le 
fichier projet ou modifiez les droits d'acces au fichier. 

R2017 Path for file nomjichier exceeds limit of 79 characters Erreur du compilateur d'aide (RTF) 

Le nom de chemin absolu ou du chemin relatif a partirdu repertoire racine comporte plus de 79 caracteres (limite imposee 
par DOS). Le fichier n'est pas pris en compte. 
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R2019 Cannot open file nomjichier Erreurdu compilateur d'aide (RTF) 

Impossible de lire le fichier specifie. Ce message indique une erreur de fichier DOS. 

R2021 Cannot find file nomjichier Erreur du compilateur d'aide (RTF) 

Impossible de trouver ou de lire le fichier specifie. Ce message indique une erreur de fichier DOS ou une memoire 
insuffisante. 

R2023 Not enough memory to build Help file Erreur du compiiateur d'aide (RTF) 

Memoire insuffisante pour compiler le fichier d'aide. Dechargez toute application, pilote de peripherique ou programme 
residents non utilise pour liberer de la memoire. 

R2025 Fi le envi ronment error Erreur du compiiateur d'aide (RTF) 

Nombre de descripteurs de fichier insuffisant pour la poursuite de la compilation. Augmentez les valeurs de FILES= et 
BUFFERS^ dans le fichier CONFIG.SYS et reinitialisez le systeme. 

R2027 Build tag nom_code not defined in [BUILDTAGS] section of project file Erreur du compilateur d'aide (RTF) 

Le code de compilation conditionnelle specifie a ete affecte a un ecran d'aide mais n'a pas ete declare dans le fichier projet. 
Ce code n'est pas pris en compte. 

R2033 Context string in Map section not defined in any topic Erreur du compilateur d'aide (RTF) 

Une ou plusieurs chaines contexte ont ete definies dans le fichier projet mais aucun ecran d'aide ne correspond a ces 
chaines. 

R2035 Build expression missing from project file Erreur du compilateur d'aide (RTF) 

Les ecrans sont definis avec des codes de compilation conditionnelle mais aucune expression Build= n'est specifiee dans le 
fichier projet. Tous les ecrans d'aide sont inclus dans la compilation. 

R2037 File nomjichier cannot be created, due to previous error(s) Erreur du compilateur d'aide (RTF) 

Impossible de creer le fichier ressource d'aide car le compilateur ne dispose plus d'ecrans a traiter. Corrigez les erreurs 
precedant cette erreur et recompilez. 

R2039 Unrecognized table formatting in topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 

Le compilateur ignore le formatage d'un tableau lorsqu'il n'est pas supporte dans le systeme d'aide. Reformatez les entrees 
du tableau de maniere lineaire, si possible. 

R2041 Jump chaine_contexte unresolved in topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 

L'ecran specifie contient une chaine contexte qui indique un ecran d'aide inexistant. Verifiez que la chaine est correctement 
orthographiee et que l'ecran d'aide est bien inclus dans cette compilation. 

R2043 Hotspot text cannot spread over paragraphs Erreur du compilateur d'aide (RTF) 

Un mot actif de saut figure sur deux paragraphes consecutifs. Supprimez le formatage de la marque du paragraphe. 

R2045 Maximum number of tab stops reached in topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 
Le systeme d'aide autorise au maximum 32 positions de tabulation. Cette limite est depassee dans l'ecran d'aide specifie. Par 
defaut, les autres tabulations ne sont pas prises en compte. 

R2047 File nomjichier not created Erreur du compilateur d'aide (RTF) 

Aucun ecran a compiler ou I'expression de compilation est incorrecte pour tous les ecrans. Le fichier ressource d'aide n'est 
pas cree. 
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R2049 Context string text too long in topic num_ecran of file nomjichier Erreurdu compilateur d'aide (RTF) 

La partie en texte cache qui correspond a la chaine contexte ne peut depasser 64 caracteres. Cette chaine contexte n'est 
pas prise en compte. 

R2051 File nomjichier is not a valid RTF topic file Erreur du compilateur d'aide (RTF) 

Le fichier specifie n'est pas un fichier RTF. Verifiez que l'ecran a ete sauvegarde dans le format RTF sous votre traitement de 
texte. 

R2053 Font nom_poiice in file nomjichier not in RTF font table Erreur du compiiateur d'aide (RTF) 

Une police non definie dans I'en-tete RTF a ete utilisee pour I'ecran. Le compilateur utilise la police systeme par defaut. 

R2055 File nomjichier is not a usable RTF topic file Erreur du compiiateur d'aide (RTF) 

Le fichier specifie contient un en-tete RTF correct mais le fichier n'est pas au format RTF ou est defectueux. 

R2057 Unrecognized graphic format in topic num_ecran of file nomjichier Erreur du compiiateur d'aide (RTF) 

Le compilateur reconnait uniquement les fichiers bitmap Windows. Verifiez que les formats metafile ou Macintosh n'ont pas 
ete utilises. Ce graphique n'est pas pris en compte. 

R2059 Context string identifier already defined in topic num_ecran of file nomjichier Erreur du compiiateur d'aide (RTF) 
L'ecran specifie est deja defini par un identificateur de chaine contexte. Le compilateur utilise I'identificateur defini dans la 
premiere note #. 

R2061 Context string nom_contexte already used in file nomjichier Erreur du compiiateur d'aide (RTF) 

La chaine contexte specifiee a deja ete affectee a un autre ecran. Le compilateur ne tient pas compte de la deuxieme chaine 
et I'ecran d'aide ne peut plus etre atteint par saut hypertexte. 

R2063 Invalid context-string identifier for topic num_ecran of file nomjichier Erreur du compiiateur d'aide (RTF) 

L'identificateur de chaine contexte contient des caracteres non alphanumeriques ou est nul. Aucun identificateur n'est affecte 
a I'ecran. 

R2065 Context string defined for index topic is unresolved Erreur du compilateur d'aide (RTF) 

L'ecran d'aide de I'index defini dans le fichier projet est introuvable. Le compilateur utilise comme index le premier ecran 
d'aide trouve dans la compilation. 

R2067 Footnote text too long in topic num_ecran of file nomjichier Erreurdu compilateur d'aide (RTF) 

Le texte des notes de bas de page est limite a mille caracteres. Cette note de bas de page n'est pas prise en compte. 

R2069 Build tag footnote not at beginning of topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 

L'ecran d'aide indique contient une note de bas de page pour un code de compilation conditionnelle, mais ce code n'est pas 
le premier caractere de l'ecran d'aide. Le code est ignore pour cet ecran d'aide. 

R2071 Footnote text missing in topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 

L'ecran specifie contient une note de bas de page ne comportant aucun caractere. 

R2073 Keyword string is null in topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 

Une note de bas de page pour un mot cle a ete specifiee mais ne comporte aucun caractere. 

R2075 Keyword string too long in topic num_ecran of file nomjichier Erreurdu compilateur d'aide (RTF) 

Le texte de la note de bas de page pour le mot cle dans l'ecran indique comporte plus de 255 caracteres. Les caracteres 
supplemental ne sont pas pris en compte. 
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R2077 Keyword(s) defined without title in topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 

Un ou plusieurs mot(s) cle ont ete definis pour cet ecran auquel aucun titre n'est affecte. La fonction Recherche de la fenetre 
d'aide affichera Rubrique sans titre« pour cet ecran d'aide. 

R2079 Browse sequence string is null in topic num_ecran of file nomjichier Erreur du compiiateur d'aide (RTF) 

La note de bas de page d'une sequence d'ecrans pour I'ecran specifie ne contient aucun caractere de sequence. 

R2081 Browse sequence string too long in topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 

La note de bas de page d'une sequence d'ecrans pour I'ecran specifie depasse 128 caracteres. La sequence n'est pas prise 
en compte. 

R2083 Missing sequence number in topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 

Signe deux-points (:) ajoute par erreur a la fin d'un numero de sequence de recherche. Supprimez ce signe ou entrez un 
numero de sequence complementaire. 

R2085 Sequence number already defined in topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 

Note de bas de page de sequence d'ecrans deja definie pour I'ecran indique. La deuxieme sequence n'est pas prise en 
compte. 

R2087 Build tag too long Erreur du compilateur d'aide (RTF) 

Un code de compilation conditionnelle pour I'ecran indique comporte plus de 32 caracteres. Ce code n'est pas pris en compte 
pour cet ecran d'aide. 

R2089 Title string null in topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 

La note de bas de page de titre de I'ecran indique ne comporte aucun caractere. Aucun titre n'est affecte a cet ecran d'aide. 

R2091 Title too long in topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 

Le titre de I'ecran indique comporte plus de 1 28 caracteres. Les caracteres supplementaires ne sont pas pris en compte. 

R2093 Title titlename in topic num_ecran of file nomjichier used previously Erreur du compilateur d'aide (RTF) 

Le titre indique a deja ete affecte a un autre ecran. 

R2095 Title defined more than once in topic num_ecran of file nomjichier Erreur du compilateur d'aide (RTF) 

Plusieurs notes de bas de page de titre ont ete specifies pour I'ecran indique. Le compilateur utilise la premiere chaine titre 
detectee. 

R2501 Using old key-phrase table Erreur du compilateur d'aide (RTF) 

Une compression maximale peut etre obtenue uniquement en supprimant le fichier PH avant chaque recompilation des 
ecrans d'aide. 

R2503 Out of memory during text compression Erreur du compilateur d'aide (RTF) 

Memoire insuffisante pour comprimer le fichier ressource d'aide. La compilation se poursuit sans compression. Dechargez 
toute application, pilote de peripherique ou programme resident non utilise pour liberer de la memoire. 

R2505 File environment error during text compression Erreur du compilateur d'aide (RTF) 

Nombre de descripteurs de fichier insuffisant pour la compression. La compilation se poursuit sans compression du fichier 
ressource d'aide. Augmentez les valeurs FILES= et BUFFERS^ dans le fichier CONFIG.SYS et reinitialisez le systeme. 

R2507 DOS file error during text compression Erreur du compilateur d'aide (RTF) 

Erreur d'acces a un fichier sur disque lors de la compression. La compilation se poursuit sans compression du fichier 
ressource d'aide. 
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R2509 Error during text compression Erreur du compilateur d'aide (RTF) 

L'une des erreurs de compression (R2503, R2505 ou R2507) s'est produite. La compilation se poursuit sans compression du 
fichier ressource d'aide. 

R2701 Internal error Erreur du compilateur d'aide (RTF) 

R2703 Internal error Erreur du compiiateur d'aide (RTF) 

R2705 Internal error Erreur du compiiateur d'aide (RTF) 

R2707 Internal error Erreur du compiiateur d'aide (RTF) 

R2709 Internal error Erreur du compiiateur d'aide (RTF) 

Pour plus de details sur la signification de ces messages contactez votre support technique Borland. 

Record kind num found, expected theadr or Iheadr in module nomjichier Erreur du bibliothecaire 

Le bibliothecaire n'a pas pu interprets I'enregistrement d'en-tete du module objet ajoute a la bibliotheque et a suppose que le 
module etait incorrect. 

Record length /en exceeds available buffer in module module Erreur du bibliothecaire 

Cette erreur se produit lorsque la longueur d'enregistrement ten depasse la taille du tampon disponible du module module et 
lorsque le bibliothecaire ne dispose plus de memoire dynamique. 

Record type type found, expected theadr or Iheadr in module Erreur du bibliothecaire 

Le bibliothecaire a detecte le type type au lieu du type d'enregistrement THEADR ou LHEADER dans le module module. 

Redefinition of macro is not identical Mise en garde du compilateur 

Le fichier source contient une redefinition d'une macro dont le texte n'est pas exactement identique a la premiere definition. 
Le nouveau texte est pris en compte. 

Redefinition of target nomjichier Erreur de MAKE 

Le nom de fichier indique figure dans la partie gauche de plusieurs regies explicites. 

Reference initialized with typel, needs lvalue of type type2 Erreur du compilateur 

Une variable ou un parametre reference qui n'est pas declare comme constante doit etre initialise avec une lvalue de type 
approprie. Ce message indique que I'initialisateur n'etait pas une lvalue ou que son type ne correspondait pas a la reference 
initialisee. 

Reference member membre in class without constructors Erreur du compilateur 

Une classe contenant des references membres doit comporter au moins un constructeur defini par I'utilisateur pour pouvoir 
initialiser ces membres. 

Reference member membre initialized with a non-reference parameter Erreur du compilateur 

Une tentative de lien entre une reference membre a un parametre a ete faite dans un constructeur. L'objet parametre perdant 
toute existence lorsque le constructeur renvoie une valeur, la reference membre ferait alors reference a un objet non defini. 
Cette erreur assez frequente peut se traduire par un blocage du systeme ou des resultats de programme inattendus. 

Reference member membre is not initialized Erreur du compilateur 

Une reference doit toujours etre initialisee. Un membre de classe de type reference doit avoir un initialisateur dans tous les 
constructeurs de cette classe. Vous ne devez done pas vous attendre a ce que le compilateur genere des constructeurs pour 
cette classe car il n'a aucun moyen de savoir comment initialiser ces references. 
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Reference member membre needs a temporary for initialization Erreur du compilateur 

La valeur initiale specifiee pour un type reference ne correspondait pas a une lvalue du type reference. Le compilateur doit 
creer une variable temporaire pour cette initialisation. Dans la mesure ou il n'existe aucun endroit evident pour stocker cette 
variable, ('initialisation est illicite. 

Reference variable variable must be initialized Erreur du compilateur 

Cet objet C++ a ete declare comme une reference mais n'a pas ete initialisee. Une reference doit imperativement etre 
initialisee au moment de sa declaration. 

Register allocation failure Erreur du compilateur 

Indication d'Erreur du compilateur. Une expression trop complexe dans la fonction indiquee a empeche la generation du code 
correspondant par le generateur de code. Essayez de simplifier cette fonction. Si le probleme persiste, notez-le et contactez 
votre support technique Borland. 

Relocation item exceeds 1MB DOS limit Erreur de I'editeur de liens 

Le format de fichier executable DOS ne gere pas les elements de reaffectation de plus de 1 Mo. Bien que DOS ne puisse pas 
chargerune image aussi volumineuse, les programmes d'acces a la memoire etendue DOS le permettent, et TLINK supporte 
la generation d'images plus volumineuses que celles gerables par DOS. Meme si I'image est chargee a I'aide d'un tel 
programme, le format de fichier executable DOS est limite a la description d'elements de reaffectation dans le premier 
mega-octet de I'image. 

Relocation offset overflow Erreur de i'editeur de liens 

Cerre erreur se produit uniqument pour des modules objet 32 bits et indique un decalage d'element de reaffectation 
(reference de segment) superieur a 64 ko (limite imposee par DOS). 

Relocation table overflow Erreur de I'editeur de liens 

Cerre erreur se produit uniquement pour des modules objet 32 bits. Le fichier lie contient plus de references de base que la 
table de reaffectation DOS standard ne peut contenir (les references de base sont creees en general par des appels a des 
fonctions far). 

Resident Name Table is greater than 64K Mise en garde de I'editeur de liens 

Lataille maximale d'une table de noms Resident est de 64 ko (conformement aux normes de I'industrie en termes de 
specifications de fichiers executables). L'edition de liens se poursuit sans tenir compte d'autres noms Resident detectes par 
la suite. 

Restarting compile using assembly Mise en garde du compilateur 

Le compilateur a detecte une instruction ASM accompagnee d'une option -B ou d'une instruction en ligne #pragma. Le 
compilateur reprend en utilisant les fonctionnalites du langage assembleur. 

Results are safe in file nomjichier Mise en garde du bibliothecaire 

Le bibliothecaire a compile la bibliotheque dans un fichier temporaire mais ne peut attribuer le nom de la bibliotheque requis a 
ce fichier. Le fichier temporaire n'est pas supprime (la bibliotheque est ainsi conservee). 

Rule line too long Erreur de MAKE 

Une regie implicite ou explicite comporte plus de 4 096 caracteres. 

Segment segment exceeds 64K Erreur de I'editeur de liens 

Ce message indique qu'un nombre trop important de donnees a ete defini pour un segment de donnees ou de code une fois 
les segments portant le meme nom combines a partir de differents fichiers sources par TLINK. 
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Segment segment is in two groups: groupel and groupe2 Mise en garde de I'editeur de liens 

Conflit entre deux groupes detecte par I'editeur de liens. Cette erreur se produit generalement dans des programmes en 
langage assembleur et indique que deux modules ont affecte le meme segment a deux groupes differents. 

Self relative f ixup overflowed in module module Mise en garde de I'editeur de liens 

Ce message s'affiche si une reference auto-relative (un appel en general) est effectuee a partir d'un segment physique sur un 
autre segment. Ceci se produit en general dans un programme en langage assembleur et egalement si vous utilisez les 
options de specification de segment avec le compilateur. Si la reference est effectuee d'un segment de code a un autre, 
aucun probleme ne devrait se produire. S'il s'agit d'une reference d'un segment de code a un segment de donnees, le 
message indique une erreur probable dans le code assembleur. L'affichage de ce message peut etre controle a I'aide de 
I'option -w. 

Size of identificateur is unknown or zero Erreur du compilateur 

Cette identificateur est utilise dans un contexte ou il est necessaire de specifier sa taille. Par exemple, un modele de 
structure a peut etre ete declare (sans que la structure n'ait ete definie) ou un tableau extern declare sans taille. Si c'est le 
cas, il est impossible d'avoir des references a ce type d'element (comme sizeof) ou de donner la correspondance d'un 
pointeur vers ce type. Modifiez votre declaration pour que la taille de identificateur soit disponible. 

sizeof may not be applied to a bit field Erreur du compilateur 

sizeof renvoie la taille en octet d'un objet de donnees (ce qui ne s'applique pas a un champ de bits). 

sizeof may not be applied to a function Erreur du compilateur 

sizeof est applicable uniquement a des objets de donnees et non a des fonctions. Vous pouvez determiner la taille d'un 
pointeur vers une fonction. 

Size of the type is unknown or zero Erreur du compilateur 

Ce type est utilise dans un contexte ou il est necessaire de specifier sa taille. Par exemple, un modele de structure a peut 
etre ete declare (sans que la structure n'ait encore ete definie). Si c'est le cas, il est impossible d'avoir des references a ce 
type d'element (comme sizeof) ou de donner la correspondance d'un pointeur vers ce type. Modifiez votre declaration pour 
que la taille de ce type soit disponible. 

identificateur specifies multiple or duplicate access Erreur du compilateur 

Une classe de base peut etre declaree publique ou privee mais pas simultanement avec les deux statuts. Un specificateur 
d'acces doit apparaitre une seule fois pour une classe de base donnee. 

Stack overflow Erreur d'execution 

La taille de pile par defaut d'un programme en Borland C++ est de 5 120 octets. Bien que cette taille soit suffisante pour la 
plupart des programmes, certains programmes executant des fonctions recursives ou stockant de nombreuses donnees 
locales peuvent entrainer un debordement de pile. Ce message s'affiche uniquement si I'option de verification de pile est 
activee. Si ce message s'affiche, essayez d'augmenter la taille de la pile ou de minimiser I'utilisation de la pile dans votre 
programme. Pour modifier la taille de la pile, redefinissez la variable _stklen. Essayez de passer a un modele de memoire 
plus grand pour contenir la pile agrandie. 

L'exemple ci-dessus illustre comment reduire le volume de donnees locales utilisees par une fonction. La variable buffer est 
declaree statique et ne consomme aucun espace de pile (a la difference de list). 

void anyf unction (void) { 

static int buffer [2000] ; /* reside dans le segment de donnees */ 

int list [2000]; /* reside sur la pile */ 

} 
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Les inconvenients d'une declaration de variable locale statique sont les suivants : 

1 . Elle occupe un espace memoire en permanence non disponible pour les variables globales ni pour le tas (ceci n'est 
qu'un inconvenient mineur) ; 

2. La fonction ne peut plus etre reentrante. Si la fonction est appelee de fagon recursive ou asynchrone et que chaque 
appel de la fonction doive disposer de sa propre copie de la variable, vous ne pouvez pas dans ce cas la declarer comme 
statique. En effet, a chaque appel de la fonction, celle-ci utilise le meme espace alloue en memoire pour cette variable au 
lieu d'allouer un espace different a chaque appel. Si la fonction essaye de s'appeler elle-meme (de fagon recursive) ou 
au meme moment oil il est fait appel a cette fonction (de fagon asynchrone), elle risque de provoquer un probleme de 
partage. Ceci n'est pas un probleme pour la plupart des programmes DOS. 

Statement missing ; Erreur du compilateur 

Point-virgule manquant a la fin d'une instruction. 

Storage class classe_stockage is not allowed here Erreur du compilateur 

Impossible de specifier la classe de stockage indiquee. Vous avez probablement specifier deux classes de stockage alors 
qu'une seule est autorisee. 

String type not allowed with this operand Erreur de MAKE 

L'operande specifie ne peut pas etre utilise pour comparer des types chaine. Utilisez les operandes ==, !=, <, >, <=, ou >=. 

Structure passed by value Mise en garde du compilateur 

Une structure a ete passee par valeur en tant qu'argument a une fonction sans prototype. Cette erreur qui consiste a omettre 
I'operateur d'adressage (&) devant une structure lorsqu'elle doit etre passee en argument est frequente en programmation ; 
elle reste cependant acceptable car une structure peut effectivement etre passee par valeur. Ce message s'affiche a titre de 
mise en garde. 

Structure required on left side of . or .* Erreur du compilateur 

La partie gauche d'un operateur point (.) ou point-etoile en C++ doit correspondre a un type structure. 

Structure size too large Erreur du compilateur 

La taille d'une structure est superieure a 64 ko. 

Style of function definition is now obsolete Mise en garde du compilateur 

En C++, la definition "en C ancienne maniere" de la fonction suivante n'est pas autorisee : 

int func (pi, p2) 
int pi, p2; 
{• • •} 

Subscripting missing ] Erreur du compilateur 

Crochet fermant manquant a la fin d'une expression d'indigage. Verifiez les operateurs specifies ou les parentheses. 

Superfluous & with function Mise en garde du compilateur 

Operateur d'adressage (&) inutile avec le nom de la fonction (tout operateur de ce type detecte est supprime). 

Suspicious pointer conversion Mise en garde du compilateur 

Le compilateur a detecte une conversion de pointeur qui a fait pointer le pointeur vers un type different. Utilisez un operateur 
de transtypage pour supprimer ce message si la conversion est correcte. 
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Switch selection expression must be of integral type Erreur du compilateur 

L'expression de selection entre parentheses dans une instruction switch doit correspondre a un type entier (char, short, int, 
long, enum). Vous pourriez utiliser un operateur de transtypage pour respecter cette condition. 

Switch statement missing ( Erreur du compilateur 

Parenthese gauche manquante apres le mot cle switch dans une instruction switch. 

Switch statement missing ) Erreur du compilateur 

Parenthese droite manquante apres l'expression test dans une une instruction switch. 

nomjichier(numjigne): Syntax error Erreur de I'editeur de liens 

Erreur de syntaxe dans le fichier de definition de modules et a la ligne indiques. 

Table limit exceeded Erreur de I'editeur de liens 

Debordement de I'une des tables internes de I'editeur de liens. Ce message indique que le programme comporte un nombre 
trap important de symboles publics, de symboles externes ou de definitions de segments logiques gerables par I'editeur de 
liens. Notez que chaque instance d'un nom de segment distinct dans un fichier objet compte pour un segment logique. Si ce 
segment est defini par deux fichiers objets, il en resulte deux segments logiques. 

Target index of FIXUP is in module module Erreur de I'editeur de liens 

Erreur du convertisseur. 

Template argument must be a constant expression Erreur du compilateur 

Un argument de classe template doit correspondre a une expression constante (ou etre de type approprie), soit une 
expression de type entier constant ou une adresse d'objet ou de fonction avec membres ou edition de liens externe. 

Template class nesting too deep: 'class' Erreur du compilateur 

Le compilateur impose une certaine limite des niveaux d'imbrication de classes templates. Cette limite est en general 
depassee par une dependance de classe template recursive. Ce message d'erreur est affiche pour toutes les classes 
template imbriquees (il est ainsi facile de detecter la recursivite). Le message Out of memory s'affiche ensuite 
systematiquement. 

A titre d'exemple, analysez le groupe de classes template suivant : 

template<class T> class A 
{ 

friend class B<T*>; 

}; 

template<class T> class B 
{ 

friend class A<T>; 

}; 

A<int> x; 
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Ce code genere les messages d'erreur suivants : 

Error: Template class nesting too deep 

Error: Template class nesting too deep 

Error: Template class nesting too deep 

Error: Template class nesting too deep 

Error: Template class nesting too deep 

Error: Template class nesting too deep 

Error: Template class nesting too deep 

Error: Template class nesting too deep 

Error: Template class nesting too deep 

Error: Template class nesting too deep 

Fatal: Out of memory 



'B<int -> 

'A<int v 

' B<int v 

'A<int J 

' B<int J 

'A<int J 

'B<int ' 

'A<int v 

' B<int v 
' A<int>' 
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Template function argument argument not used in argument types Erreurdu compilateur 

['argument indique n'a pas ete utilise dans la liste d'arguments de la fonction. La liste d'arguments d'une fonction template 
doit utiliser tous les arguments formels de template. A cette seule condition, une instance de la fonction template peut etre 
generee a partir des types d'argument specifies. 

Template functions may only have type-arguments Erreur du compilateur 

Une fonction template a ete declaree avec un argument non type. Cette declaration n'est pas autorisee car il est alors 
impossible de specifier la valeur lors de I'appel de la fonction template. 

Templates can only be declared at file level Erreur du compilateur 

Un template ne peut pas etre declare dans une classe ou une fonction. II est possible de le declarer uniquement au niveau 
global (au niveau du fichier). 

Templates must be classes or functions Erreur du compilateur 

La declaration d'un template doit specifier un type classe ou une fonction. 

Temporary used to initialize identificateur 

Temporary used for parameter numero in call to fonction 

Temporary used for parameter parametre in call to fonction 

Temporary used for parameter numero 

Temporary used for parameter parametre Mise en garde du compilateur 

En C++, une variable ou un parametre de type reference n'accepte pour affectation qu'une reference a un objet du meme 
type. Si les types sont incompatibles, la valeur effective est affectee a une valeur temporaire de type approprie. L'adresse de 
cette variable temporaire est alors affectee a la variable ou au parametre de type reference. Ce message indique que la 
variable ou le parametre de type reference ne font pas reference a la variable attendue mais a une variable temporaire qui 
n'est autrement pas utilisee. 



Mise en garde du compilateur 
Mise en garde du compilateur 
Mise en garde du compilateur 
Mise en garde du compilateur 
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Dans I'exemple suivant, la fonction f neecessite une reference a un entier (int) et c est un caractere (char) : 

f (ints) ; 
char c; 
f (c); 

Au lieu d'appeler la fonction f avec I'adresse de c, le compilateur genere un code equivalent au code source C++ : 

int X = c, f (X) ; 

Terminated by user Erreur de i'editeur de liens 

Vous avez mis fin explicitement a I'edition de liens. 

The '...' handler must be last Erreur du compilateur 

Le gestionnaire '...' doit figurer a la fin d'une liste de gestionnaires catch. 

The combinations '+*' or '*+' are not allowed Erreur du bibliothecaire 

Impossible d'ajouter ou d'extraire un module objet d'une bibliotheque en une seule operation. Vous avez probablement 
indiquer I'operation '+-'. 

The constructor constructeur is not allowed Erreurdu compilateur 

Les constructeurs de la forme X::(X) ne sont pas autorises. La syntaxe correcte d'un contructeur de copie est la suivante : 
X::(constX&). 

The value for identificateuns not within the range of an int Erreurdu compilateur 

La valeur d'un enumerates doit etre representee sous la forme d'un entier. La valeur que vous avez essaye d'affecter n'est 
pas comprise dans I'intervalle des valeurs entieres. En C++, vous devez utilisez un entier de type constant. 

'this' can be used only within a member function Erreurdu compilateur 

En C++, this est un mot reserve a utiliser uniquement dans une fonction de membre de classe. 

This initialization is only partly bracketed Mise en garde du compilateur 

Erreur d'accolade dans une initialisation apres avoir selectionne EDI Options|Compiler|Messages|ANSI violations. Chaque 
membre d'une structure peut etre initialise en etant specifie entre accolades. Si un membre est un tableau ou une structure, il 
est possible d'imbriquer plusieurs niveaux d'accolades. Cette syntaxe garantit que le compilateur affecte les valeurs aux 
membres exactement comme vous I'avez specifie. Ce message s'affiche si vous oubliez de specifier certaines des accolades 
facultatives. 

Too few arguments in template class name template Erreurdu compilateur 

Certaines valeurs des parametres formels d'un nom de classe template n'ont pas ete specifies. 

Too few parameters i n cal I Erreur du compilateur 

Les arguments d'un appel de fonction avec prototype (via un pointeurde fonction) n'ont pas tous ete specifies. Tous les 
parametres doivent etre specifies. 

Too few parameters i n cal I to fonction Erreur du compilateur 

Les arguments d'un appel de la fonction indiquee (declaree avec un prototype) n'ont pas tous ete specifies. 

Too many commas on command-line Erreur de I'editeur de liens 

Entree incorrecte dans la ligne de commande. 

Too many deci mal poi nts Erreur du compilateur 

Plusieurs virgules decimales ont ete detectees dans une constante en virgule flottante. 
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Too many default cases Erreur du compilateur 

Plusieurs expressions default ont ete detectees dans une instruction switch. 

Too many default libraries Erreur du compilateur 

L'editeur de liens ne peut gerer qu'un maximum de 1 28 bibliotheques. 

Too many error or warning messages Erreur du compilateur 

Un maximum de 255 messages d'erreur et de mise en garde peut etre defini avant que le compilateur ne s'arrete. 

Too many error or warning messages Erreur de l'editeur de liens 

Le nombre de messages affiches par le compilateur est superieur a 255. Ce message indique que TLINK a atteint cette limite. 

Too many errors Erreur de l'editeur de liens 

Le compilateur a detecte un nombre d'erreurs plus important que celui autorise par I'option -E. 

Too many exponents Erreur du compilateur 

Plusieurs exposants ont ete detectes dans une constante en virgule flottante. 

Too many initializers Erreur du compilateur 

Un nombre d'initialisateurs plus important que celui autorise par la declaration initialisee a ete detecte. 

Too many LNAMEs Erreur de l'editeur de liens 

Un fichier .OBJ ne doit pas comporter plus de 256 LNAME (limite imposee pr TLINK). 

Too many segments Erreur de l'editeur de liens 

Un fichier .OBJ ne doit pas comporter plus de 256 SEGDEF (limite imposee par TLINK). 

Too many storage classes in declaration Erreur du compilateur 

Une declaration ne peut pas avoir plusieurs classes de stockage. 

Too many suffixes in .SUFFIXES list Erreur de MAKE 

La liste de suffixes peut comporter un maximum de 255 suffixes autorises. 

Too many types in declaration Erreur du compilateur 

Une declaration ne peut avoir plusieurs types de base (char, int, float, double, struct, union, enum ou typedef-nom). 

Too much global data defined in file Erreur du compilateur 

La somme des declarations de donnees globales depasse 64 ko. Verifiez la declaration d'un tableau qui pourrait etre trap 
grand, modifiez le programme ou utilisez des variables far si toutes les declarations sont requises. 

Trying to derive a far class from the huge base base Erreur du compilateur 

Si une classe de base est declaree huge (ou prend cette valeur par defaut), toutes les classes derivees doivent egalement 
etre declarees huge. 

Trying to derive a far class from the near base base Erreur du compilateur 

Si une classe de base est declaree near (ou prend cette valeur par defaut), toutes les classes derivees doivent egalement 
etre declarees near. 

Trying to derive a huge class from the far base base Erreur du compilateur 

Si une classe de base est declaree far (ou prend cette valeur par defaut), toutes les classes derivees doivent egalement etre 
declarees far. 
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Trying to derive a huge class from the near base base Erreurdu compilateur 

Si une classe de base est declaree near (ou prend cette valeur par defaut), toutes les classes derivees doivent egalement 
etre declarees near. 

Trying to derive a near class from the far base base Erreurdu compilateur 

Si une classe de base est declaree far (ou prend cette valeur par defaut), toutes les classes derivees doivent egalement etre 
declarees far. 

Trying to derive a near class from the huge base base Erreurdu compilateur 

Si une classe de base est declaree huge (ou prend cette valeur par defaut), toutes les classes derivees doivent egalement 
etre declarees huge. 

Two consecutive dots Erreur du compilateur 

Deux points consecutifs n'ont aucune signification dans un programme en C. Vous avez peut-etre voulu specifier des points 
de suspension (...), un separateur decimal ou un operateur de selection de membre (.). 

Two operands must evaluate to the same type Erreurdu compilateur 

Les types des expressions de part et d'autre du signe deux-points de I'operateur d'expression conditionnelle (?:) doivent etre 
identiques sauf pour les conversions usuelles (char en int, float en double ou void* en pointeur particulier). Ce message 
indique que les types sont differents et ne sont pas converts automatiquement. Corrigez ou convertissez explicitement les 
types en question. 

Type type is not a defined class with virtual functions Erreurdu compilateur 

Un dynamic_cast a ete utilise avec un pointeur vers un type de classe qui n'est pas defini ou qui n'a pas de fonctions 
membres virtuelles. 

Remarque sur les erreurs de compatibility de types : 

Lors de la compilation d'un programme C++, les messages d'erreur suivants qui indiquent une incompatibilite de type sont 
toujours precedes d'un autre message qui explique la raison exacte de cette incompatibilite. En general, il s'agit du message 
"Cannot convert typel to type2" mais d'autres raisons sont possibles. 

Type mismatch in default argument value Erreurdu compilateur 

Type mismatch in default value for parameter parametre Erreur du compilateur 

La valeur du parametre par defaut indiquee n'a pas pu etre convertie dans le type du parametre. Le premier message 
s'affiche si aucun nom n'a ete affecte aux parametres. Reportez-vous a la remarque sur les messages d'erreur indiquant une 
incompatibilite de types. 

Type mismatch in parameter numero Erreurdu compilateur 

La fonction appelee, par I'intermediaire d'un pointeur de fonction, a ete declaree avec un prototype. Le parametre numero 
indique (les parametres sont comptes de gauche a droite danbs I'ordre croissant) n'a pas pu etre convert dans le type du 
parametre declare. Reportez-vous a la remarque sur les messages d'erreur indiquant une incompatibilite de types. 

Type mismatch in parameter numero in call to fonction Erreurdu compilateur 

La fonction indiquee est declaree avec un prototype dans le fichier source et le parametre numero (les parametres sont 
comptes de gauche a droite danbs I'ordre croissant) n'a pas pu etre convert dans le type du parametre declare. 
Reportez-vous a la remarque sur les messages d'erreur indiquant une incompatibilite de types. 
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Type mismatch in parameter parametre Erreur du compilateur 

La fonction appelee via un pointeur de fonction est declaree avec un prototype dans le fichier source et le parametre specifies 
n'a pas pu etre converti dans le type du parametre declare. Reportez-vous a la remarque sur les messages d'erreur indiquant 
une incompatibilite de types. 

Type mismatch in parameter parametre in call to fonction Erreur du compilateur 

La fonction appelee via un pointeur de fonction est declaree avec un prototype dans le fichier source et le parametre specifie 
n'a pas pu etre converti dans le type du parametre declare. Reportez-vous au message Type mismatch in parameter 
parametre et a la remarque sur les messages d'erreur indiquant une incompatibilite de types. 

Type mismatch in parameter parametre in template class name template Erreur du compilateur 

Type mismatch in parameter numero in template class name template Erreur du compilateur 

La valeur d'argument de template fournie pour le parametre specifie ne correspondait pas exactement au type du parametre 
formel de template. Reportez-vous a la remarque sur les messages d'erreur indiquant une incompatibilite de types. 

Type mismatch in redeclaration of identificateur Erreur du compilateur 

Redeclaration de I'identificateur indique avec un type autre que le type initial. Ce message s'affiche par exemple lorsqu'une 
fonction est appelee et declaree ensuite pour renvoyer une valeur d'un type autre qu'un entier. Vous devez dans ce cas 
declarer la fonction avant de I'appeler pour la premiere fois. Reportez-vous a la remarque sur les messages d'erreur indiquant 
une incompatibilite de types. 

Type name expected Erreur du compilateur 

L'une des erreurs suivantes s'est produite : 

■ Aucun nom de type ou aucune classe de stockage n'a ete specifie lors de la declaration d'une variable de niveau de fichier 
ou d'un champ de structure. 

■ Aucun type de nom n'a ete specifie dans une declaration typedef . 

■ Le nom du destructeur specifie dans la declaration d'un destructeur d'une classe C++ ne correspondait pas a un nom de 
type (il doit correspondre au nom de sa classe). 

■ Le nom specifie pour une classe de base C++ ne correspondait pas a un nom de classe. 

Type qualifier identificateur must be a struct or class name Erreur du compilateur 

Le qualificateur d'une construction qual : : identificateur ne correspond pas au nom d'une structure ou d'une 
classe. 

Unable to create output file nomjichier Erreur du compilateur 

Disque de travail sature ou protege contre I'ecriture ou repertoire de sortie inexistant. Si le disque est sature, essayez de 
supprimer des fichiers non utilises et recompilez. Si le disque est protege contre I'ecriture, deplacez les fichiers sources sur 
un disque accessible en ecriture et recompilez. 

Unable to create turboc.$ln Erreur du compilateur 

Le compilateur ne peut pas creer le fichier temporaire TURBOC.$LN car le disque est sature ou protege contre I'ecriture. 

Unable to execute command: commande Erreur de MAKE 

La commande indiquee n'a pas pu etre executee. L'une des erreurs suivantes s'est produite : 

■ le fichier de la commande n'a pas ete trouve ; 

■ le nom du fichier de commande est incorrectement specifie ; 
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■ le repertoire de permutation indique est sature ou inexistant ; 

■ le fichier de la commande est defecteux (raison moins probable). 

Unable to execute command commande Erreur du compilateur 

TLINK ou TASM introuvable ou disque defectueux. 

Unable to open file nomjichier Erreur de MAKE 

Unable to open nomjichier Erreur de I'editeur de liens 

Norn du fichier indique inexistant ou incorrectement specifie. 

Unable to open nomjichierfor output Erreur du bibliothecaire 

Le bibliothecaire ne peut pas ouvrir le fichier indique pour la sortie. Ce message indique un espace insuffisant pour la 
bibliotheque cible ou un fichier de listage. II s'affiche egalement si le fichier de bibliotheque cible existe mais n'est accessible 
qu'en lecture seulement. 

Unable to open include file nomjichier Erreur du compilateur 

Le compilateur n'a pas pu trouver le fichier indique. Ce message peut etre du a une auto-inclusion du fichier #include ou au 
fait que la variable FILES n'est pas definie dans le fichier CONFIG.SYS de votre repertoire racine (specifiez files=2 o). 
Verifiez que le fichier indique existe. 

Unable to open include file nomjichier Erreur de MAKE 

Le compilateur n'a pas pu trouver le fichier indique. Ce message peut etre du a une auto-inclusion du fichier linclude ou au 
fait que la variable FILES n'est pas definie dans le fichier CONFIG.SYS de votre repertoire racine (specifiez files=2 o). 
Verifiez que le fichier indique existe. 

Unable to open input file nomjichier Erreur du compilateur 

Fichier source introuvable. Verifiez que le nom du fichier est correctement specifie et que le fichier figure sur le disque ou 
dans le repertoire approprie. 

Unable to open makefile Erreur de MAKE 

Le repertoire en cours ne contient pas le fichier MAKE specifie (fichier MAKEFILE.MAK par defaut) ou le fichier que vous 
avez specifie avec -f . 

Unable to redirect input or output Erreur de MAKE 

MAKE n'a pas pu ouvrir les fichiers temporaires necessaires pour rediriger les entrees ou les sorties. Si vous etes connecte 
en reseau, verifiez que vous disposez des droits d'acces sur le repertoire en cours. 

Unable to rename nomJichierXo nomjichier Erreur du bibliothecaire 

Le bibliothecaire compile une bibliotheque dans un fichier temporaire et reaffecte le nom du fichier de bibliotheque cible a ce 
fichier temporaire. Ce message s'affiche en cas d'erreur (il indique en general un espace insuffisant sur disque). 

Undefined label identificateur Erreur du compilateur 

L'etiquette indiquee comporte une instruction goto mais n'a pas ete definie. 

Undefined structure identificateur Mise en garde du compilateur 

La structure indiquee a probablement ete specifiee au niveau d'un pointeur vers une structure. Cette structure n'a cependant 
pas ete definie dans le fichier source. Verifiez que la structure a effectivement ete declaree et correctement specifiee. 
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Undefined structure structure Erreurdu compilateur 

La structure indiquee a ete specifiee sur une ligne precedant I'endroit de I'erreur (probablement au niveau d'un pointeur vers 
une structure) mais aucune declaration de cette structure n'a ete effectuee. Verifiez que la structure a effectivement ete 
declaree et correctement specifiee. 

Undefined symbol identificateur Erreurdu compilateur 

L'identificateur indique n'a pas ete declare. Verifiez qu'il a ete correctement specifie a cet endroit ou au niveau de la 
declaration ou que la declaration est correcte. 

Undefined symbol symbole in module module Erreur de I'editeur de liens 

II est fait reference au symbole dans le module specifie mais le symbole n'est defini dans aucun des fichiers objet et 
bibliotheques inclus dans I'edition de liens. Verifiez que le nom du symbole a ete correctement specifie. 

TLINK genere ce message si des incompatibilites de declarations d'un symbole de type pascal et cdecl dans differents 
fichiers sources ont ete detectees ou si vous avez omis le nom d'un fichier .OBJ requis par votre programme. Si vous liez du 
code C++ avec des modules C, vous avez peut-etre oublie de specifier des declarations externes C dans extern " c " 
{...}. Verifiez que les deux symboles debutent bien soit par une majuscule soit par une minuscule. Reportez-vous aux 
options /C et /c. 

Unexpected } Erreur du compilateur 

Une accolade fermante a ete ajoutee par erreur. Verifiez s'il ne manque pas une accolade ouvrante ({). 

Unexpected char Xin command line Erreurdu bibliothecaire 

Erreur de syntaxe detectee dans la ligne de commande. 

Unexpected end of file Erreur de MAKE 

La fin du fichier MAKE a ete atteinte alors qu'un fichier inline temporaire n'a pas ete ferme. 

Unexpected end of file in comment started on numjigne Erreur de MAKE 

La fin d'un fichier source a ete atteinte au milieu d'un commentaire. Verifiez que le commentaire est correctement termine 
par 7. 

Unexpected end of file in conditional started on line numjigne Erreurdu compilateur 

La fin du fichier source a ete atteinte avant que le compilateur (ou MAKE) ne detecte une instruction lendif. Verifiez que lendif 
a effectivement et correctement specifiee. 

Union cannot be a base type Erreur du compilateur 

Une union ne peut etre utilisee comme type de base d'une autre classe. 

Union cannot have a base type Erreur du compilateur 

A union ne peut etre derivee d'une autre classe. 

Union member membre is of type class with constructor Erreur du compilateur 

Union member membre is of type class with destructor Erreur du compilateur 

Union member membre is of type class with operators Erreur du compilateur 

Une union ne peut comporter de membres de type classe avec des constructeurs, destructeurs ou I'operateur = definis par 
I'utilisateur. 

Unions cannot have virtual member functions Erreurdu compilateur 

Une union ne peut avoir un fonction virtuelle comme membre. 
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Unknown assembler instruction Mise en garde du compilateur 

Le compilateur a detecte une instruction en assembleur en ligne. 

Unknown command line switch Xignored Mise en garde du bibliothecaire 

La ligne de commande ou un fichier de recherche comporte un caractere de barre oblique (/) sans qu'il soit suivi d'une des 
options autorisees. 

Unknown language, must be C or C++ Erreur du compilateur 

Dans la construction C++ 

extern "nora" type f unc ( /*...*/ ) ; 

"nom" doit correspondre a "C" ou "C++" uniquement. Tout autre nom de langage n'est pas reconnu. 

Vous pouvez declarer une fonction externe en Pascal sans que le compilateur la renomme, comme suit : 

extern "C" int pascal f unc ( /*...*/ ); 

Une fonction C++ (eventuellement surcharged) peut etre declaree Pascal et permettre au compilateur de la renommer 
(c'est-a-dire de la surcharger), comme suit : 

extern int pascal f unc ( /*...*/ ) ; 

Unknown option Erreur de I'editeur de liens 

La ligne de commande ou un fichier de recherche comporte un caractere de barre oblique @notct[(/)], un trait d'union 
(SYMBOL NOTCT -) ou un caractere d'option DOS sans qu'il soit suivi d'une des options autorisees. Verifiez que I'option est 
correctement specifiee en majuscules ou en minuscules. 

Unknown preprocessor directive: identificateur Erreur du compilateur 

Le compilateur a detecte un caractere # au debut d'une ligne suivi d'un nom de directive non autorise ou la specification du 
reste de la directive est incorrecte. 

Unknown preprocessor statement Erreur de MAKE 

Un caractere ! a ete detecte au debut d'une ligne suivi d'un nom d'instruction non autorise. Vous devez specifier error, undef , 
if, elif, include, else ou endif . 

Unreachable code Mise en garde du compilateur 

Une instruction break, continue, goto ou return doit etre suivie d'une etiquette ou de I'instruction de fin d'une boucle ou 
d'une fonction. Le compilateur verifie les boucles while, do et for avec une condition de test constante et tente de 
reconnaitre les boucles qui ne s'interrompent pas. 

Unsupported option chaine Erreur de I'editeur de liens 

Option d'edition de liens incorrecte. 

Unterminated string or character constant Erreur du compilateur 

Apostrophe manquante a la fin d'une chaine ou d'un caractere de type constant. 

Use '> >' for nested templates instead of '»' Mise en garde du compilateur 

Espace manquant entre deux caracteres ">" a la fin d'un nom de template imbrique. Le compilateur tolere cette erreur tres 
frequente et la signale comme une mise en garde. 

Use . or -> to call fonction Erreur du compilateur 

Vous avez essaye d'appeler une fonction membre sans specifier d'objet. 
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Use . or -> to call membre, or & to take its address Erreur du compilateur 

Le compilateur a detecte une reference a un membre de classe non statique sans objet. Ce membre doit etre utilise avec un 
objet ou son adresse recuperee a I'aide de I'operateur &. 

Use :: to take the address of a member function Erreurdu compilateur 

Si f est une fonction membre d'une classe c, I'adresse de cette fonction peut etre obtenue avec la syntaxe &c::f. Notez 
I'utilisation d'un nom de type classe plutot que le nom d'un objet et I'operateur :: entre le nom de la classe et le nom de la 
fonction. Un pointeur de fonction membre n'est pas un vrai type de pointeur et ne fait reference a aucune instance particuliere 
d'une classe. 

Use le with TLINK to obtain debug information from library Mise en garde du bibliothecaire 

La bibliotheque a ete compilee avec un dictionnaire etendu et inclut des informations de debogage. TLINK ne peut extraire 
des informations de debogage si I'edition de liens inclut un dictionnaire etendu. Par consequent, pour obtenir ces informations 
dans un executable a partir de cette bibliotheque, vous devez specifier I'option le pour que I'editeur de liens ne tienne pas 
compte du dictionnaire etendu. L'editeur de liens de I'environnement integre Borland C++ ne gere pas les dictionnaires 
etendus, il est done inutile de reconfigurer I'environnement. 

Use of : and :: dependents for target cible Erreur de MAKE 

Vous avez tente d'utiliser un nom de cible simultanement dans des blocs descripteurs simples et multiples (en utilisant 
successivement les operateurs : et ::). Voici un exemple : 

fichiera: fichierb 
fichiera:: fichierc 

Use qualified name to access nested type type Mlse en garde du compilateur 

Dans des versions precedentes de C++, les noms de typedef et de modeles de structure declares dans des classes etaient 
directement accessibles a un niveau global. Dans la version actuelle de C++, ces noms doivent etre avoir un qualificateur 
classe:: comme prefixe s'ils doivent etre utilises en dehors de la portee de leur classe. Pour pouvoir compiler un code ecrit 
selon les specifications precedentes, Borland C++ permet d'utiliser sans prefixe un tel nom definissant une seule classe mais 
genere ce message de mise en garde. 

User break Erreur du compilateur 

Vous avez mis fin explicitement a la compilation ou a I'edition de liens dans I'environnement integre en appuyant sur 
Ctrl+Pause. Ce message n'est pas une erreur mais une simple confirmation. 

Using based linking for DLLs may cause the DLL to malfunction Mise en garde de I'editeur de liens 

Ce message s'affiche si vous utilisez I'option IB lors de I'edition de liens d'une bibliotheque DLL. Dans pratiquement tous les 
cas, cette erreur empeche I'execution normale de I'application. L'affichage de ce message peut etre controle a I'aide de 
I'option -w. 

Value of type void is not allowed Erreurdu compilateur 

Une valeur de type void ne correspond en fait a aucune valeur tangible et ne peut done apparaitre dans un contexte oil une 
valeur est requise (par exemple, partie droite d'une affectation, argument d'une fonction, expression de controle d'une 
instruction if, for ou while). 

VIRDEF Name Conflict for fonction 

Un nom dont la longueur depasse la limite imposee par I'editeur de liens est systematiquement tronque le compilateur. Dans 
de tres rares cas, deux noms tronques peuvent etre exactement identiques. Si ces noms sont des noms de VIRDEF, le 
compilateur genere ce message d'erreur. Pour resoudre ce probleme, modifiez le nom de la fonction indiquee. 
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Variable identificateur is initialized more than once Erreur du compilateur 

Cette variable a ete initialisee plusieurs fois. II est possible de declarer plusieurs fois une variable de niveau de fichier mais 
cette variable ne peut etre initialisee qu'une seule fois. 

'virtual' can only be used with member functions Erreur du compilateur 

Une donnee membre a ete declaree avec le specificateur virtual reserve uniquement a des fonctions membres. 

Virtual function fonction 1 conflicts with base class base Erreur du compilateur 

Une fonction virtuelle a ete declaree avec les memes types d'argument que celle d'une classe de base. Cette declaration 
n'est pas autorisee. 

Virtual specified more than once Erreur du compilateur 

En C++, le mot reserve virtual ne peut etre specifie qu'une seule fois dans la declaration d'une fonction membre. 

void & is not a valid type Erreur du compilateur 

Un reference fait systematiquement reference a un objet. Cet objet ne peut pas avoir le type void. 

Void functions may not return a value Mise en garde du compilateur 

La fonction en cours est declaree void mais le compilateur a detecte une instruction return avec une valeur. Cette valeur 
n'est pas prise en compte. 

fonction was previously declared with the language langage Erreur du compilateur 

La declaration extern de la fonction indiquee autorise I'utilisation d'un seul langage. Cette fonction a ete declaree avec 
plusieurs langages a differents endroits du meme module. 

While statement missing ( Erreur du compilateur 

Parenthese gauche manquante apres le mot cle while dans une boucle de repetition while. 

While statement missing ) Erreur du compilateur 

Parenthese droite manquante apres I'expression test dans une boucle de repetition while. 

Ce message s'affiche si TLINK n'a pas pu ecrire toutes les donnees en raison d'un disque probablement sature. 

Write error on file nomjichier Erreur de MAKE 

MAKE n'a pas pu acceder en lecture ou en ecriture au fichier specifie dans le fichier MAKE. Verifiez que le disque n'est pas 
sature et que vous y avez acces en ecriture. 

Wrong number of arguments in call of macro macro Erreur du compilateur 

La macro-instruction indiquee a ete appelee dans le fichier source avec un nombre d'arguments incorrects. 
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Controles personnalises Windows 
de Borlanc 



Avant de lire cette annexe, familiarisez-vous avec les commandes des boites 
de dialogue et l'editeur Dialog. Vous trouverez au chapitre 15 des 
renseignement sur ces questions. 

La bibliotheque de controles personnalises Windows de Borland (BWCC) 
contient une classe de dialogues personnalises et un ensemble de controles 
personnalises (boutons, cases a cocher, groupes ombres, etc.). Ces controles 
renforcent l'impact visuel de vos boites de dialogue et en optimisent les 
fonctions. 

Deux des fichiers en ligne fournis avec Resource Workshop donnent des 
renseignements complementaires sur les controles personnalises Windows 
de Borland : 

■ BWCCAPI.RW donne des renseignements techniques sur l'interface du 
programme d'application des controles personnalises Windows de 
Borland. 

■ BWCCSTYL.RW propose quelques styles pour creer des boites de 
dialogue de style Borland. 

Utilisation de la classe Borland de dialogues personnalises 

La classe de dialogues personnalises BORDLG a une action a la fois visuelle 
et fonctionnelle : 

■ Elle ameliore l'apparence de votre fenetre de dialogue en peignant le fond 
avec un pinceau qui varie en fonction de l'ecran de l'application. Pour les 
ecrans VGA et de resolution superieure, le fond est une fine grille de 
lignes blanches perpendiculaires produisant un effet de metal cisele. Pour 
les ecrans EGA et monochromes, le fond est blanc. 
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■ Elle optimise le tracage des boites de dialogue en appelant directement les 
routines de dessin des controles personnalises, au lieu d'attendre que 
Windows peigne les controles, ce qui accelere la realisation des boites de 
dialogue, autrement assez laborieuse. 

Pour utiliser la classe de dialogues personnalises, 

1. Ouvrez la ressource de dialogue que vous voulez convertir. 

2. Double-cliquez sur la barre de titre du dialogue pour afficher la boite de 
dialogue Window Style. 

3. Indiquez "bordlg" comme classe et cliquez sur OK. 



Utilisation des controles Borland 



Les controles Borland ajoutent a vos boites de dialogue un effet de relief qui 
renforce leur impact visuel. Pour l'utilisateur final, elles fonctionnent 
comme les controles Windows standard, mais en integrant plusieurs 
ameliorations techniques (decrites plus loin). 

La figure ci-dessous montre une boite de dialogue convertie en BWCC qui 
utilise plusieurs controles Borland. 



Figure B.1 Boutons radio 
Boite de dialogue Borland 
avec controles 



Cases a cocher 
Borland 



Borland 



Options 



Shape 



Square 

Circle 

Triangle 



Colo 



Blue 
Yellow 



Red 
White 




Boutons-poussoirs 
Borland 



-Fond 



M3roupe ombre 

_Ligne horizontale 
en creux 
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Vous trouverez ci-apres un rapide descriptif de chaque commande, 
accompagne d'une icone de l'outil correspondant. Comme pour les 
controles Windows standard, vous pouvez inserer des controles Borland 
dans vos dialogues en allant les chercher dans la palette d'outils de l'editeur 
Dialog. 

La classe de chaque controle est precisee dans le descriptif. Pour voir la 
classe et les autres parametres de l'un quelconque de ces controles, affichez 
la boite de dialogue Generic Control Style en appuyant sur la touche Ctrl et 
en double-cliquant simultanement sur le controle. 

Groupe ombre Boite rectangulaire ombree qui regroupe visuellement 
d'autres controles. Peut apparaitre comme grave dans la 
boite de dialogue ou en relief. Appartient a la classe 
BorShade. 



Ligne horizontale 
en creux 



Ligne verticale 
en creux 



Ligne horizontale divisant la boite de dialogue et 
dormant l'impression d'etre gravee dans la boite de 
dialogue. (Peut etre transformee en ligne "en relief"). 
Appartient a la classe BorShade. 

Meme chose que la Ligne horizontale en creux, mais 
dans le sens vertical. Appartient a la classe BorShade. 



j£l 



T 



Bouton-poussoir 
Borland 



Bouton radio 
Borland 



Case a cocher 
Borland 



Texte statique 
Borland 



Famillle de boutons-poussoirs avec des symboles ayant 
un grand impact visuel, plus une option "owner-draw". 
Les boutons-poussoirs Borland sont plus grands que la 
plupart des boutons-poussoirs Windows standard. lis 
appartiennent a la classe BorBtn. 

Bouton en relief en forme de losange. Quand on clique 
sur ce bouton, un losange noir apparait au centre et 
l'ombrage s'inverse, donnant l'impression que le bouton 
a ete enfonce. II y a egalement une option de 
"owner-draw". Appartient a la classe BorRadio. 

Case a cocher en relief affichant une coche au lieu d'un 
"X." II y a egalement une option Owner-draw. 
Appartient a la classeBorCfecfc 

Chaine de texte fixe utilisee principalement pour 
etiqueter certaines parties de la boite de dialogue. 
Appartient a la classeBorStoh'c. 
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Perfectionnements 
des boutons et 
cases a cocher 



Utilisation des 
boites de dialogue 
de style BWCC 



Les boutons-poussoirs, boutons radio et cases a cocher Borland ont, sur les 
commandes Windows classiques, les avantages fonctionnels suivants : 

■ Un niveau supplementaire de notification aux fenetres meres et de 
controle de la fenetre de premier plan Windows et des tabulations. Si vous 
selectionnez l'option Parent Notify dans la boite de dialogue de style du 
controle, celui-ci envoie les messages appropries, selectionnes dans la liste 
suivante, au moment de l'execution : 

• BBN_SETFOCUS indique a la fenetre mere que le bouton-poussoir, le 
bouton radio ou la case a cocher est la cible de toutes les entrees clavier 
autrement que par cliquage de la souris. 

• BBN_SETFOCUSMOUSE indique a la fenetre mere que le 
bouton-poussoir, le bouton radio ou la case a cocher est la cible de toutes 
les entrees clavier par cliquage de la souris. 

• BBN_GOTATAB indique a la fenetre mere que l'utilisateur a appuye sur 
la touche Tab alors que le bouton-poussoir, le bouton radio ou la case a 
cocher est la cible de toutes les entrees clavier. La fenetre mere peut 
intervenir dans le traitement de la frappe en retournant une valeur 
differente de zero. 

• BBN_GOTABTAB indique a la fenetre mere que l'utilisateur a appuye 
sur Maj+Tab (espace arriere) alors que le bouton-poussoir, le bouton radio 
ou la case a cocher est la cible de toutes les entrees clavier. La fenetre 
mere peut intervenir dans le traitement de la frappe en retournant une 
valeur differente de zero. 

■ Une option "owner-draw" qui permet a la fenetre mere de dessiner le 
bouton-poussoir, le bouton radio ou la case a cocher. Dans la mesure ou 
c'est votre application qui se charge du dessin, ils ne ressembleront pas 
necessairement a des commandes Borland, mais auront toutefois le 
comportement type de leur classe de commande. 

Quatre boites de dialogue permette de definir le style des controles BWCC : 

■ Borland Button Style 

■ Borland Radio Button Style 

■ Borland Check Box Style 

■ Borland Shade Style 

Pour afficher l'une des ces boites de dialogue, double-cliquez sur le controle 
dont vous voulez definir le style. 
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Boite de dialogue 
Borland Button 
Style 



Chacun possede une fenetre permettant de saisir une legende et un ID de 
controle. Les boites de dialogue Button style, Radio button style et Check 
box style ont des options d'attributs (Attributes Options) pour Tab Stop, 
Disabled, Group, Visible, et Border, ainsi que Parent Notify et Owner Draw 
(decrits plus haut). 

Les quatre sections qui suivent decrivent les fonctions specifiques a chaque 
boite de dialogue de style. 

Cette boite de dialogue permet de choisir parmi les trois types de bouton : 
Pushbutton, Defpushbutton et Bitmap. 

Pushbutton et Defpushbutton 

Pushbutton est l'option par defaut. Ce type de bouton est entoure d'une 
bordure en gras pour indiquer a l'utilisateur qu'il s'agit du bouton par defaut, 
execute quand l'utilisateur appuie sur la touche Entree. (La seule exception 
est quand la fenetre de premier plan Windows est dans une commande Edit 
Text pour laquelle l'indicateur Want Return a ete active. Reportez-vous au 
tableau 15.11 pour une description de l'indicateur Want Return.) 

La premiere fois que vous inserez un bouton Borland dans une boite de 
dialogue, son texte est Button et il prend le premier ID disponible dans 
l'ordre. Pour remplacer le bouton par l'un des boutons Borland standard, 
remplacez 1TD de controle par l'une des valeurs predefinies du tableau 
suivant : 



Tableau B.1 

Boutons de 

controles BWCC 

predefinis 



Norn de I'lD 


Valeurde I'lD 


Type 


Representation 


IDOK 


1 


OK 


Coche verte 


IDCANCEL 
IDABORT 


2 
3 


Annuler 
Abandonner 


X rouge 
Touche SOS 


IDRETRY 
IDIGNORE 

I DYES 


4 

5 

6 


Reessayer 
Ignorer 

Oui 


Machine a sous 

Panneau de limite de vitesse 
a 55 mph 

Coche verte 


IDNO 


7 


Non 


Cercle rouge barre 


IDHELP 


998 


Aide 


Point d'interrogation bleu 
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Le bitmap ne s'affiche 

pas dans I'editeur 

Dialog tant que I'editeur 

Bitmap n'est pas ferme. 



Bitmap 

L' option Bitmap vous permet d'inserer une image bitmap (appelee par son 
ID de controle) dans le bouton. Pour lire dans une image bitmap : 

1. Utilisez le controle Bouton pour inserer le bouton generique BWCC dans 
votre boite de dialogue. Notez son ID de controle. 

2. Appelez I'editeur Bitmap et creez une image bitmap. (Voir page 234 pour 
plus d'informations sur la creation de bitmaps.) 

3. Dans I'editeur Bitmap, selectionnez Resource I Rename pour afficher la 
boite de dialogue Rename Resource puis executez l'une des deux actions 
suivantes : 

• Dans la boite de texte New Name entrez un entier egal a l'ID de controle 
du bouton auquel vous aurez ajoute la valeur de decalage indiquee dans 
le tableau B.2. 

• Renommez le bitmap et affectez-lui un identificateur dont la valeur sera 
egale a l'ID de controle du bouton auquel vous ajouterez le decalage 
indique dans le tableau B.2. (La creation des identificateurs est expliquee 
au chapitre 14.) 

1. Fermez I'editeur Bitmap. 

2. Revenez a I'editeur Dialog. Si le bitmap n'apparait pas immediatement a 
l'interieur du bouton BWCC, redimensionnez le bouton. Le bitmap doit 
alors apparaitre. 



Tableau B.2 
Decalages Bitmap 



Etat du bouton 



Standard 
Appuye 
Fenetre active 



Decalage pour 
VGA et resolutions 
superieures 

1000 
3000 
5000 



Decalage pour 
EGA/monochrome 



2000 
4000 
6000 



Par exemple, pour afficher le bitmap de fenetre active d'un bouton dont l'ID 
de controle est 276, entrez 5276 pour un ecran VGA, 6276 pour un ecran 
EGA. 
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Boite de dialogue 
Borland Radio 
Button Style 



Boite de dialogue 
Borland Check Box 
Style 



Boite de dialogue 
Borland Shade 
Style 



Cette boite de dialogue propose deux styles de bouton : 

■ Bouton radio. La mise en surbrillance et la deselection ne sont pas 
automatiques. L'application doit appeler la fonction CheckRadioButton 
pour envoyer un message BM_SETCHECK qui mettra en surbrillance le 
bouton selectionne et deselectionnera les autres boutons. 

■ Auto radio button. BWCC et Windows s'associent pour prendre en charge 
la mise en surbrillance du bouton selectionne et la deselection des autres 
boutons. C'est l'option par defaut. 

Cette boite de dialogue propose quatre styles de cases a cocher : 

■ Check box. La case n'est pas cochee automatiquement. L'application doit 
appeler la fonction CheckDIgButton pour envoyer un message 
BM_SETCHECK qui cochera la case selectionnee. 

■ Auto check box. BWCC et Windows s'associent pour cocher la case 
selectionnee. C'est l'option par defaut. 

■ 3-state. La case n'est pas cochee automatiquement. L'application doit 
appeler la fonction CheckDIgButton pour envoyer un message 
BM_SETCHECK qui cochera la case selectionnee. 

Les trois etats du bouton sont actif, inactif, et "indetermine," represente par 
un motif a damier. L'application determine ce qui est sous-entendu par 
"indetermine". 

■ Auto 3-state. BWCC et Windows s'associent pour cocher la case 
selectionnee. 

Cette boite de dialogue vous propose trois outils pour definir le style des 
controles que vous avez ajoutes ; ces outils sont : groupe ombre, ligne 
horizontale en creux et ligne verticale en creux. Les boutons radio de Shade 
Style vous permettent d'effectuer les conversions suivantes : 

■ Group Shade to Raised Shade. Les groupes ombres et les ombrages en relief 
servent a regrouper ensemble des controles dont les fonctions sont liees - 
par exemple des boutons radio et des cases a cocher. Les groupes ombres 
semblent graves dans la surface de la boite de dialogue, les ombrages en 
relief apparaissent en relief par rapport a cette surface. 

■ Horizontal Dip to Horizontal Bump, Vertical Dip to Vertical Bump. Les lignes 
en creux ont un role de separateurs dans les boites de dialogue ou les 
ombrages en relief ; les lignes en relief ont un role de separateurs dans les 
boites a fond grise grave. 
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Boite de dialogue 
Borland Static Text 
Style 



Cette boite de dialogue permet de saisir du texte, de definir les attributs et 
de choisir le style du texte statique Borland. 

Outre les attributs standard (Disabled, Group et Visible), le texte statique 
possede deux attributs supplementaires : 

■ Quand l'option Border est cochee, le texte statique est entoure d'un cadre 
Windows standard qui utilise la couleur active de la fenetre principale de 
Windows (voir l'Ecran de controle Windows) ; 

■ Quand l'option No Underline est cochee, un signe perluete (&) apparait 
comme caractere constant, au lieu de souligner le caractere suivant de la 
legende. 

Les options de Control Style sont decrites dans le tableau 15.12. II y a 
cependant une difference majeure : towttexte statique BWCC, y compris 
Simple Text, utilise le fond standard BWCC gris. 



Modifier des applications existantes avec BWCC 



Les paragraphes qui 

suivent decrivent ces 

operations plus en 

detail. 



Resource Workshop vous permet de modifier des applications Windows 
existantes en introduisant des controles personnalises de style Borland 
(boutons 3D, boites de dialogue a aspect "metal cisele", etc.). Cette procedure 
s'effectue en deux temps : 

1. Modifiez votre fichier WIN.INI pour charger la bibliotheque Borland 
Windows Custom Control (BWCC) chaque fois que vous lancez 
Windows. 

2. Modifiez l'application dans Resource Workshop pour changer de 
fonctions d'interfaces utilisateur, par exemple les boites de dialogue, les 
menus, les icones, etc. 



Chargement de 
BWCC pour activer 
les controles 
Borland 



La bibliotheque BWCC, qui permet la prise en charge des controles 
personnalises de style Borland, doit etre chargee pour qu'une application 
puisse utiliser les fonctions BWCC. 

Modifiez le fichier WIN.INI (situe dans le repertoire principal de Windows) 
pour que Windows charge le fichier LOADBWCC.EXE dans la memoire au 
demarrage. (Le programme d'installation met LOADBWCC.EXE dans le 
repertoire des fichiers executables du compilateur et ajoute ce repertoire 
dans votre CHEMIN.) 
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Utilisation de 
BWCCdansdes 
programmes C et 
C++ 



Ajoutez LOADBWCC.EXE au debut de la liste de fichiers qui apparait a la 
suite de l'instruction "LOAD=". II doit d'abord apparaitre dans l'instruction, 
afin que BWCC soit charge en memoire avant d'executer toute application 
modifiee. 

Par exemple, si l'instruction LOAD de votre fichier WIN.INI est : 

LOAD=NWPOPUP .EXE AD . EXE 

vous devez modifier l'instruction comme suit : 

LOAD=loadbwcc.exe NWPOPUP.EXE AD. EXE 

Si vous utilisez l'EDI Borland C++, cochez BWCC quand vous creez une 
application (voir le chapitre 2 pour toute information sur les projets de 
l'EDI). Vous devez aussi ajouter BWCCGetVersion ( ) ; dans WinMain. 

Si vous n'utilisez pas l'EDI, la procedure est la suivante : 

■ Ajoutez une #include pour BWCC.H dans votre fichier .C ou .CPP. 

■ Ajoutez BWCC. LIB dans votre projet EDI C ou C++, ou inserez-le dans le 
champ TLINK Library avant IMPORT.LIB. 

■ Ajoutez BWCCGetVersion () ; dans WinMain. 



Astuces sur les 
modifications de 
ressources 



Cette section evoque ce que vous ne devez pas perdre de vue quand vous 
modifiez les ressources d'applications existantes. 



Accelerateurs 



Si vous ajoutez un accelerateur, assurez-vous qu'il retourne le meme ID que 
la commande de menu correspondante. Sinon, soit l'accelerateur executera 
une mauvaise commande, soit il ne fera rien. 



Bitmaps, curseurs 
eticones 



Boites de dialogue 



Vous pouvez modifier les bitmaps, curseurs et icones existants. N'effacez 
pas de bitmaps, de curseurs ni d'icones, n'essayez pas d'en ajouter. Dans la 
plupart des cas, l'application ne sera pas capable de les utiliser. 

Vous pouvez deplacer des elements a l'interieur d'une boite de dialogue et 
convertir les controles en controles personnalises Borland equivalents. Lors 
de la modification, veillez a ne pas changer le type de controle associe a 
chaque ID de controle. Par exemple, si l'ID de controle 100 est une case a 
cocher, ne le transformez pas en bouton radio, car l'application continuera a 
le considerer comme une case a cocher. 
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Dans la plupart des cas, vous pouvez supprimer des controles qui ne sont 
pas directement lies aux fonctions de 1' application. Vous pouvez par 
exemple supprimer une legende, un texte statique qui n'a aucun effet sur le 
fonctionnement de l'application. Ne supprimez pas de controle d'edition : 
cela aura une incidence sur le fonctionnement de l'application. 

N'ajoutez pas de nouveaux controles ; l'application ne sera pas capable de 
les utiliser. 



Menus 



Avec la plupart des applications vous pouvez sans risque deplacer des 
commandes a l'interieur d'un menu. Mais ne deplacez pas des commandes 
d'un menu a un autre. (Par exemple ne deplacez pas la commande Open du 
menu File au menu Edit.) Sinon, ['application risque de ne pas etre capable 
d'afficher l'aide contextuelle, ni de cocher ou decocher les commandes des 
menus. Ne changez jamais l'ordre des menus dans la barre des menus. Par 
exemple, si File est le premier menu, ne le mettez pas en deuxieme place. 



Tables de chaines Faites attention quand vous modifiez des tables de chaines existantes. 

Certains programmes chargent les chaines dans des tampons de taille fixe et 
le fait d'ajouter du texte a une chaine existante peut entrainer un 
depassement de la capacite du tampon. N'ajoutez pas de nouvelles chaines : 
l'application ne sera pas capable de les utiliser. 
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Principe 



En-tetes precompiles 



Borland C++ peut generer et par consequent utiliser des en-tetes 
precompiles pour vos projets. Les en-tetes precompiles permettent 
d'accelerer considerablement la procedure de compilation. 



Pour compiler des programmes C et C++ volumineux, le compilateur peut 
passer la moitie de son temps a analyser la syntaxe des fichiers d'en-tetes. 
Pendant cette operation, il insere des declarations et des definitions dans sa 
table de symboles. Or, si dix de vos fichiers source ont le meme fichier 
d'en-tetes, le compilateur l'analysera dix fois en produisant a chaque fois la 
meme table de symboles. 

Les fichiers d'en-tetes precompiles permettent un gain de temps 
considerable. Au cours de la compilation, BCC.EXE memorise une image de 
la table des symboles dans un fichier intitule par defaut BCDEF.CSM 
(BC32DEF.CSM pour BCC32.EXE). BCDEF.CSM est enregistre dans le meme 
repertoire que le compilateur. Par la suite, quand le meme fichier source (ou 
un autre fichier source contenant les memes fichiers d'en-tetes) est 
recompile, le compilateur recharge BCDEF.CSM a partir du disque au lieu 
de recommencer l'analyse de syntaxe de tous les fichiers d'en-tetes. Le 
rechargement direct de la table des symboles a partir du disque est dix fois 
plus rapide que l'analyse de la syntaxe du texte des fichiers d'en-tetes. 

Les en-tetes precompiles ne sont utilises que si la seconde compilation 
utilise un ou plusieurs fichiers d'en-tetes, options de compilateur, macros, 
etc. de la premiere compilation. 

Si, en cours de compilation d'un fichier source, Borland C++ s'apercoit que 
les premiers #include sont identiques a ceux d'une compilation anterieure 
(de la meme source ou d'une source differente), il charge l'image binaire de 
ces #include et analyse la syntaxe des #include restants. 
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Pour un module donne, soit la totalite des en-tetes precompiles est utilisee, 
soit aucun : si la compilation d'un fichier d'en-tete quelconque echoue, le 
fichier d'en-tete precompile n'est pas mis a jour pour ce module. 



Inconvenients Quand vous utilisez des en-tetes precompiles, BCDEF.CSM peut devenir 

tres volumineux du fait qu'il stocke les images des tables de symboles de 
tous les ensembles de directives #include rencontres dans vos sources. Si 
vous n'avez pas assez d'espace sur votre disque, un message vous previent 
que l'ecriture a echoue a cause des en-tetes precompiles. Pour regler ce 
probleme, faites de la place sur votre disque et relancez la compilation. Pour 
de plus amples renseignements sur la maniere de reduire la taille du fichier 
BCDEF.CSM, reportez-vous a la section "Optimisation des en-tetes 
precompiles", plus haut dans cette annexe. 

Si dans un fichier Make vous utilisez des macros importantes en plus des 
en-tetes precompiles, la taille des macros est limitee : 4 ko pour les 
applications 16 bits et 16 ko pour les applications 32 bits. 

Si un en-tete comporte un code quelconque, il ne peut pas etre compile. 
Ainsi, bien qu'il puisse y avoir des definitions de classes C++ dans des 
fichiers d'en-tetes, assurez-vous que seules des fonctions membres en ligne 
sont definies dans l'en-tete et qu'elles tiennent compte de mises en garde du 
type "Functions containing for are not expanded inline". 

Comment utiliser des en-tetes precompiles 

Vous pouvez commander l'utilisation des en-tetes precompiles de 
differentes manieres : 

■ A partir de l'EDI, grace a la boite de dialogue des Project Options. L'EDI 
cree le nom du fichier d'en-tetes precompile a partir du nom du projet, 
soitPKO/ECT.CSM 

■ A partir de la ligne de commande, a l'aide des options -H, -H=nom_fichier, 
-He, -H"nom_fichier"et -Hu (voir la section "Compiler I Precompiled 
headers" du chapitre 3) 

■ A partir de votre code, a l'aide des directives pragma hdrfile et hdrstop 
(voir le chapitre 5 du Guide du programmeur) 
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Creation des noms 
de fichiers 



Attention ! 



Le compilateur utilise un seul fichier pour stacker toutes les en-tetes 
precompiles. Le nom par defaut de ce fichier est BCDEF.CSM. Mais vous 
pouvez lui donner le nom de votre choix a l'aide de l'option de ligne de 
commande -H=nom_fichier ou de la directive #pragma hdrfile . 

Si vous avez l'impression que votre fichier .CSM est plus petit qu'il ne 
devrait, il se peut que le compilateur ait manque d'espace disque pour 
enregistrer les en-tetes dans le fichier .CSM. Dans ce cas, le compilateur 
efface le fichier .CSM pour faire de la place au fichier .OBJ, puis cree un 
nouveau fichier .CSM (par consequent moins important). Si vous vous 
trouvez dans cette situation, faites de la place sur le disque avant de 
proceder a la compilation. 



Controle d'identite 



Pour qu'un en-tete precompile prealablement genere puisse etre charge 
pour une autre compilation, les conditions suivantes doivent etre remplies. 

Le deuxieme ou le dernier fichier source doit : 

■ Avoir le meme groupe de fichiers a inclure, classes dans le meme ordre 

■ Avoir les memes macros definies pour des valeurs identiques 

■ Utiliser le meme langage (C ou C++) 

■ Utiliser des fichiers d'en-tetes de meme date ; ils pourront etre inclus soit 
directement, soit indirectement 

Vous devrez aussi, lors de la compilation du nouveau fichier source, 
conserver les memes valeurs pour les options enumerees ci-apres (par 
exemple, si vous avez compile le premier fichier avec le modele SMALL, 
vous devez compiler le second fichier avec ce meme modele) : 

■ Modele memoire, y compris SS != DS (-mx) 

■ Prefixe de soulignement pour les extrema (-u) " 

■ Taille maximum des identificateurs (-iL) 

■ Destination DOS (par defaut) ou Windows (-W ou -Wx) 

■ Code de recouvrement compatible DOS (-Y) 

■ Commande des tables virtuelles (-Vx et -Vmx) 

■ Expansion en ligne des fonctions intrinseques (-Oi) 

■ Modeles (-Jx) 

■ Constantes de type chaine dans le segment code (-de, 16 bits seulement) 

■ Informations de debogage (-v, -vi, et -R) 

■ Variables far (-Fx) 
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Generation de l'alignement sur mot (-a) 
Conventions d'appel Pascal (-p) 
Traitement des enum comme des entiers (-b) 
char non signes par defaut (-K) 
Conformite du langage (-A) 
Compilation C++ (-P) 



Optimisation des 

en-tetes 

precompiled 



ASOURCE.C 



BSOURCE.C 



BSOURCE.C modifie 



Pour une compilation optimale avec des en-tetes precompiles, observez les 
regies suivantes : 

■ Enregistrez vos fichiers d'en-tetes dans le meme ordre dans tous vos 
fichiers source. 

■ Mettez en premier les plus gros fichiers d'en-tetes. 

■ Dans BCDEF.CSM, mettez en premier les sequences de fichiers d'en-tetes 
les plus souvent utilisees. 

■ Utilisez #pragma hdrstop pour delimiter la liste des fichiers d'en-tetes au 
bon endroit. Vous aurez ainsi dans les differentes sources une liste de 
fichiers d'en-tetes similaire a celle du compilateur. #pragma hdrstop est 
decrite plus en detail dans le chapitre 5 du Guide du programmeur. 

Par exemple, dans le cas de deux fichiers source ASOURCE.C et 
BSOURCE.C, contenant tous deux windows.h et myhdr.h, 

#include <windows.h> 
#include "myhdr.h" 
#include "xxx.h" 

< . . . > 

#include "zz.h" 
#include <string.h> 
#include "myhdr.h" 
#include <windows.h> 

< . . . > 

il est conseille de reorganiser le debut de BSOURCE.C de la maniere 
suivante : 

#include <windows.h> 
#include "myhdr.h" 
#include "zz .h" 
#include <string.h> 

< . . . > 



482 



Borland C++ Guide de I'utilisateur 



Notez que windows .h et myhdr.h sont dans le meme ordre dans 
BSOURCE.C et dans ASOURCE.C. Vous pouvez aussi creer une nouvelle 
source intitulee PREFIX.C contenant uniquement les fichiers d'en-tetes, a 
savoir : 



PREFIX.C #include <windows.h> 

#include "myhdr.h" 



Si vous compilez PREFIX.C en premier (ou si vous inserez une directive 
#pragma hdrstop dans ASOURCE.C et dans BSOURCE.C a la suite de la 
directive #include "myhdr . h" ) apres la compilation initiale de 
PREFIX.C, ASOURCE.C et BSOURCE.C seront en mesure de charger la table 
de symbole produite par PREFIX.C. Le compilateur n'aura plus qu'a 
analyser la syntaxe de xxx.h pour ASOURCE.C, celle de zz.h et de string.h 
pour BSOURCE.C. 
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D 



Utilisation d'EasyWin 



Easy Win est une fonction de Borland C++ qui vous permet de compiler des 
applications DOS standard utilisant les entrees et sorties de type TTY 
traditionnelles pour les faire tourner comme de veritables programmes 
Windows. Avec EasyWin, vous n'avez aucune modification a apporter aux 
programmes DOS pour leur permettre de tourner sous Windows. 



Convertir des applications DOS en applications Windows : un jeu d'enfant 



Pour convertir celles de vos applications machines qui utilisent des fichiers 
ou fonctions iostream standard, verifiez la valeur de EasyWin Target Type 
dans TargetExpert dans EDI. Si vous travaillez avec le compilateur de ligne 
de commandes, utilisez le commutateur -W. Borland C++ note que votre 
programme ne contient pas la fonction WinMain (en principe necessaire 
pour les applications Windows) et edite un lien avec la bibliotheque 
d'EasyWin. Quand vous faites tourner votre programme sous Windows, 
une fenetre standard est creee et votre programme recoit des entrees et 
produit des sorties dans cette fenetre exactement comme s'il s'agissait de 
l'ecran standard. 

Exemple de programme en C : Exemple de programme C++ : 



#include <stio.h> #include <iostream.h> 

main ( ) main() 

{ { 

printf ("Hello, world\n"); cout « "Hello, world\n"; 

return 0; return 0; 
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La fenetre d'EasyWin peut etre utilisee chaque fois qu'un peripherique TTY 
demande une entree ou une sortie. Cela signifie que stderr, stdaux, et cerr 
sont tous, au meme titre que stdin et stdout, connectes a cette fenetre. 



JnitEasyWin( ) 



L'objet d'EasyWin est de vous permettre de convertir rapidement et 
facilement des applications DOS en programmes Windows. Mais vous 
pouvez de temps a autre avoir besoin d'utiliser EasyWin a partir d'un 
programme Windows proprement dit, par exemple ajouter des fonctions 
print/ au code de votre programme pour deboger votre programme 
Windows. 

Pour utiliser EasyWin a partir d'un programme Windows, appelez la 
fonction _InitEasyWin avant d'effectuer toute entree ou sortie standard. 



Par exemple : 



#include <windows.h> 
#include <stio.h> 



Vous trouverez le 

prototype 

d'JnitEasyWin dans 

stdio.h et iostream.h. 



fpragma argsused 

int PASCAL WinMain (HANDLE hlnstance, HANDLE hPrevInstance, 

LPSTR IpszCmdLine, int cmdShow) 
{ 

_InitEasyWin () ; 

/* Normal windows setup */ 
printf ( "Hello, world\n"); 
return 0; 



} 
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Fonctions 
supplementaires 



Reportez-vous au 

paragraphe LR, 

chapitre RTL, pour la 

description des 

fonctions disponibles 

avec les programmes 

EasyWin. 



Pour plus de commodite, EasyWin possede cinq fonctions supplementaires 
qui vous permettent d'indiquer les coordonnees X et Y de la fenetre pour les 
entrees et les sorties, d'effacer la fenetre ou d'effacer la fin de la ligne en 
cours : 



clreol 

clrscr 

gotoxy 

wherex 

wherey 



(conio.h) 
(conio.h) 
(conio.h) 
(conio.h) 
(conio.h) 



Ces fonctions ont le meme nom (et role) que les fonctions du fichier 
d'en-tete conio.h. Les classes de constrea.h offrent des fonctions conio pour 
les flux C++. Reportez-vous au chapitre 6 du Guide du programmeur pour une 
presentation complete de constreams et iostreams. 

Les programmes suivants peuvent etre adaptes aux programmes d'EasyWin 
mais ne sont pas disponibles au format Windows 16 bits. lis sont fournis 
pour faciliter le portage du code existant dans une application Windows 16 
bits. 



fgetchar 


(stdio.h) 


getch 


(stdio.h) 


getchar 


(stdio.h) 


getche 


(stdio.h) 


gets 


(stdio.h) 


kbhit 


(conio.h) 


perror 


(errno.h) 


printf 


(stdio.h) 


putch 


(conio.h) 


putchar 


(stdio.h) 


puts 


(stdio.h) 


scanf 


(stdio.h) 


vprintf 


(stdio.h) 


vscanf 


(stdio.h) 
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Index 



"Memoire insuffisante" (erreur) 

et outils 32 bits 11 
#defines 253 

afficher 242 
$* (macro MAKE) 

compatibilite avec NMAKE 111 
$d (macro MAKE) 

compatibilite avec NMAKE 212 
&, dans le texte d'une commande menu 314 
* (symbole d'action TLIB 206 
+, sujets AppExpert 97 
+ (symbole d'action TLIB) 206 
-, sujets AppExpert 97 
- (symbole d'action TLIB 206 
-* et *- (symboles d'action TLIB 206 
-+ et +- (symboles d'action TLIB) 206 
-? (option MAKE) 220 
-d (option MAKE) 210 
-m (option MAKE) 210 
.HLP (fichiers) 

creation 96 
/0, option TLIB (enregistrement de commentaire) 
205 
-2 (option BCC) 

instructions 80286 68 
-3 (option BCC) 

instructions 80386 68, 76 
32 bits, ressources dans Resource Workshop 261 
-4 (option BCC) 

instructions 80486 68, 76 
-5 (option BCC) 

instructions Pentium 76 
~, symbole de fichier de sauvegarde 259 
\a, caractere d'alignement a droite dans les menus 
315 
\t, caractere de tabulation dans les menus 315 



-A (option BCC EXE) 175 - 9-176 
alignement d'entier 68, 76 



mots-cles ANSI 66 
Absolute (options de grille) 277 
Absolute Align (style), boites de dialogue 267 
ACBP (champ) 179 
accelerateurs 

astuces et reserves 477 
Accelerator (editeur) 323 

boite texte Command 329 

lancer 325 

mode Key Value 327 

mode Manual 330 

utiliser avec l'editeur Menu 326 

volet Attribute 326 

volet Outline 326 
activer les commandes de menu 313 
Add to Project (commande) 245 
adresse de base 176 
Advanced (bouton) 

TargetExpert et 28 
Aerographe 350 

forme de pinceau, choisir 363 

options de couleur 350 

motifs 363 
affichage 

des declarations de symboles 18 

des details d'un objet 18 

des avertissements, options 119 
affichage (options), dans l'editeur Dialog 300 
Aide 

activation 10 

scripts ressource 244 
Airbrush Shape (commande) 363 
ajouter (symbole d'action TLIB) 206 
aj outer 

des caracteres, ressource police 390 

des identificateurs 254 

un libelle 266 

un suivi a la fenetre Watch 127 
Align Controls (boite de dialogue) 282 
alignement (options), boite de dialogue Edit Text 
Style 293 - 15-294 



Index 
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alignement a droite, dans les menus 315 
alignement de mot et d'entier 68, 76 
aligner 

controles 277 

zone selectionnee, editeur Bitmap 365 
annuler258, 287 
ANSI 

code compatible 66 

conformite de langage (Borland C++, specifique a 

l'implementation), option 66 

regies de conversion de calculs flottants 64 
AppExpert 

+ et - avec les sujets 97 

classes, ajout 109 

classes, visualisation 107 

description 95 

fichiers crees 96 

gestionnaires, ajout 112 

gestionnaires, suppression 112 

et ObjectWindows 95 

variables d'instance 
ajout 113 
suppression 113 
AppExpert Application Generation Options, boite 
de dialogue 97 

AppExpert, Resource Workshop et 253 
applications 

creation avec AppExpert 95 - 4-96 

par defaut dans AppExpert 98 

Microsoft Windows 

segments de code 179 
arborescence AppExpert 

description 97 
arborescence de fenetres 143 
arguments 

transmettre au programme a deboguer 121 

visualiser les arguments transmis 125 
arguments de classes 

transmis par valeur 78 
arreter un programme 126 
ASCII (touches de raccourci) 324 
ASM (fichiers) 

BCC 48 
assembleur 

deboguer 124 



par defaut 91 
-AT (option BCC. EXE) 

mots-cles Borland C++ 66 
attribut big 179 
Attribute (volet) 

editeur Menu 309 

editeur Accelerator) 326 
attributs 179 

mise en surbrillance de la syntaxe et 15 
-AU (option BCC. EXE) 

conformite UNIX 66 
Auto 3-state (controle bouton 288 
Auto check box (BWCC) 475 
Auto Check Box (controle) 287 
Auto radio button (BWCC) 475 
Auto Radio Button (controle) 288 
AUTOEXEC.BAT 

et la memoire 21 
Automatic Scroll (options), boite de dialogue Edit 
Text Style 293 
avertissements 

activation et deactivation 87 

affichage 119 

fenetre de messages, recherche 15 

nombre limite 120 

selection 119 

B 

-b (option BCC.EXE) 176, 210 

(attribue un mot complet pour enums) 63 

traitement de code assembleur 90 
barre d'etat 

texte affiche 13 
barre d'icones 

boutons estompes 9 

Browser 16 

modification 11 
barre de defilement 289 

ajouter aux controles 278 

ajouter dans le cadre d'une boite de dialogue 

15-267 

options 290 

boite de dialogue Edit Text Style 293 

vertical (controle boite de dialogue) 272 
barre menu, rupture de ligne 313 
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BBN_GOTABTAB 472 
BBN_GOTATAB 472 
BBN_SETFOCUS 472 
BBN_SETFOCUSMOUSE 472 

BCC 

macros, definition 62 
BCC.EXE 

aide en ligne de commande 48 

BCC32.EXE 47 

options 

dans les fichiers 49 
desactiver 48 
en ligne de commande 48 
priorite 48 - 3-49 

regies de priorite des options 49 

syntaxe 47 - 3-48 

TLINKet 171 

utilisation 47 
BCC32.EXE 

BCC.EXE 47 

options, desactiver 48 

TLINKet 171 
BC32DEF.CSM 68 
BCCONFIG.BCW 13 
BCDEF.CSM 68, 479-C-480 
BCWDEF.DSW 13 
BG dans la palette Colors 346 
bibliotheques 171 - 9-171 

applications DPMI et 172 

applications Win32 et 172 

deboguer 138 

fichiers 60 

mathematiques 172 

options de compilateur en ligne de commande 61 

polices 237 

recherche 61 

recreation 65 

repertoires 60 

repertoires, option en ligne de commande 60 

TLINKet 171 

TLINK, ignorer 178 

TLINK32eU72 

virgule flottante 64 

Windows 3.x applications et 171 
bitmaps 



accessoires pour boutons BWCC 474 
astuces et reserves 477 
Black Frame (type de controle statique) 296 
Black Rectangle (type de controle statique) 296 
BM_SETCHECK (BWCC) 475 
BN_CLICKED 288 

boite a options combinees (controle boite de 
dialogue) 272 

Borland Button Style (boite de dialogue) 473 
Borland Check Box Style (boite de dialogue) 475 
Borland Radio Button Style (boite de dialogue) 475 
Borland Shade Style (boite de dialogue) 475 
Borland Static Text Style (boite de dialogue)476 
Boite de peinture 350 
options de couleur 350 
problemes de remplissage 351 
boites a options combinees 297 
boites de dialogue 263 
option de grille 277 

affectation de classes personnalisees 469 
affecter des classes personnalisees 269 
astuces et reserves 477 
Borland Check Box Style 475 
Borland Shade Style 475 
Borland Static Text Style 476 
comparer 303 

composants (illustration) 263 
controles 269 

barre de defilement vertical 272 
boite a options combinees 272 
boite groupe 272 
boite liste 272 
bouton radio 271 
bouton-poussoir 271 
case a cocher 272 
edition texte 272 
personnalises 273 
rectangle noir 273 
statique texte 272 
statiques en forme d'icone 272 
categorie 269 
coordonnees (illustration) 277 
creer 263 

definition 233, 263 
deplacer 265 
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editer 264 
enregistrer 302 
menus 268 

modification d'une classe de controle 279 
non-modales 268 
option de grille Relative 277 
option de style Caption 278 
option de style Control ID 278 
option de style Scroll Bar 278 
polices 268 

position definie par Windows 269 
proteger les soeurs des fenetres 267 
redimensionner 265 
regrouper des controles 281 
Select Font 268 
selectionner 265 

specifier les controles comme des taquets de 
tabulation 280 

styles de dialogue 266 
Style (controles) 277 
styles 

Absolute Align 267 

Clip Children 267 

Clip Siblings 267 

Horizontal Scroll 267 

Local Edit 267 

Maximize Box 267 

Minimize Box 267 

Modal Frame 267 

No Idle Messages 267 

System Menu 266 

System Modal 267 

Thick Frame 267 

Vertical Scroll 267 

Visible 268 
styles de cadres 266 

Border 266 

Caption 266 

Dialog Frame 266 

No Border 266 
styles de fenetre 

Child 266 

Overlapped 266 

Popup 266 
tester 301 



texte, entree utilisateur 292 

visualiser deux boites en meme temps 303 

zone client 267 
boites de dialogue (illustration) 

New Project 239 

Size Controls 285 

Window Style 265 
boites groupe 

options 287 

controle boite de dialogue 272 
boites liste 290 

controle boite de dialogue 272 

dans des boites a options combinees 297 

trier les elements 299 
Border (attribute de controle) 279 
Border (style de cadre), boites de dialogue 266 
Borland C++ 3.1 

utilisation 21 
bouton droit de la souris 

editeur Bitmap 346 
Bouton radio Borland 471 
Bouton-poussoir Borland 471 
boutons 

Browser 16 

modification dans les barres d'icones 11 

personnalises 288 
boutons de controle BWCC 473 
boutons radio 271, 288 

BWCC 475 

options 287 
boutons-poussoirs 271, 287 

BWCC 473 

ID de controle predefinis (BWCC) 473 

identificateurs de controle predefinis (Windows) 
288 

options 287 

par defaut (BWCC) 473 
BRC 

appel 195 

outil de ressource 191, 195 
BRCC (compilateur de ressources Borland 191 - 
10-192 

appel 192 
Break Before (options), menus 313 
Breakpoint (commande) 133 
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Breakpoint Properties (boite de dialogue) 134 

Breakpoints (fenetre) 133 

Brief 

raccourcis clavier de l'editeur 13 
Browse 

nouveau projet et 27 
Browser (EDI Windows) 
barre d'icones 16 
objets 17 

et definition de classe 16 
filtres 17 
activation 16 
bugs 119 
BUILTINS.MAK 
description 208 
texte 208 
Button Style (boite de dialogue) 287 
BWCC 

Auto check box 475 
Auto radio button 475 
boites de dialogue 

Borland Button Style 473 
Borland Check Box Style 475 
Borland Radio Button Style 475 
Borland Shade Style 475 
boutons de controle 473 
cases a cocher 
3-state 475 
Auto 3-state 475 
classe BORDLG 469 
controles 470 
messages 

BBN_GOTABTAB 472 
BBN_GOTATAB 472 
BBN_SETFOCUS 472 
BBN_SETFOCUSMOUSE 472 
boutons et cases a cocher 472 
Option owner-draw 472 

programmes en langage C, utilisation dans les 477 
BWCC, bitmaps 

accessoires pour boutons 474 
decalages 474 
BWCC, controles 

bouton radio Borland 471 
bouton-poussoir Borland 471 



case a cocher Borland 471 
groupe ombre 471, 475 
ligne horizontale en creux 471 
ligne verticale en creux 471 
lignes en creux, conversion 475 
lignes en relief, conversion 475 
texte statique 471 

BWCCAPI.RW 469 

BWCCSTYL.RW 469 



.C (fichiers) 176, 202 - 11-203 

commentaires imbriques 65 

compilation 48 

sans edition de liens 90 
C++ 

code non optimal 89 

code obsolete 88 

erreurs 88 - 3-89 

gestion d'exceptions 80 
cadre de pile standard 

generation 66 
cadre de selection 265, 304 
cadre noir (controle boite de dialogue) 272 
cadres 

boites de dialogue 266 

dessiner 352 
calculs flottants 

regies de conversion ANSI 64 
Call Stack 

commande de menu 225 

fenetre 125 
Caption (fenetre) 279 
Caption (option Style) 278 
Caption (style de cadre), boites de dialogue 266 
caractere souligne dans les menus 314 
caractere Tab 

texte statique 295 
caracteres 

ajouter a une ressource police 390 

definir la largeur dans une ressource police 391 
caracteres de soulignement 65 

generation automatique 65 
Case (options), boite de dialogue Edit Text Style 
293 
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case 3-state (BWCC) 475 
Case a cocher Borland 471 
case a cocher 3-State 288 

BWCC 475 
cases a cocher 272, 287 

BWCC 475 

options 287 
CBS_DISABLENOSCROLL (style) 299 
__cdecl 69, 77 

option en ligne de commande 69, 77 
CGA Resolution (commande), editeur Icon 372 
chaines 

litterale, fusion 63 

ressources definies par l'utilisateur 399 

terminees par un zero 400 

transfert de constantes dans le segment 

de code 71 
Character (options), polices 391 
Check Dup Keys (commande), editeur Accelerator 
330 

Check Duplicates (commande), editeur Menu 317 
Checked (option), menus 313 
CheckDlgButton (BWCC) 475 
CheckMenuItem (fonction) 313 
CheckRadioButton (BWCC) 475 
Child 

style de fenetre 266 
ciseaux (outil) 348 
.CKB (fichier) 

description 13 
classe BORDLG 469 

classe de controle (boites de dialogue), changer 279 
classes 

ajout (ClassExpert) 109 

ClassExpert et 107 

et DLL 299 

partage d'objets 72 

visualisation 107 
Classes (volet de ClassExpert) 

description 108 
classes personnalisees 269, 469 
ClassExpert 

acces au code source 114 

classes 

ajout 109 



visualisation 107 
coches 112 
description 107 
gestionnaires 
ajout 112 
suppression 112 
parties 107 

source, visualisation 114 
variables d'instance 
ajout 113 
suppression 113 
volets 107 

Resource Workshop et 114 
clavier dans les boites de dialogue 280 
clic (technique de selection) 273 
clignotement des elements de menu 330 
Clip Children (style), boites de dialogue 267 
Clip Siblings (style), boites de dialogue 267 
coches 

evenements et (ClassExpert) 112 
code 

non optimal (mises en garde) 89 
optimisation 81 
combinaison d'attributs 179 
Combo box (controle boite de dialogue) 272 
Combo Box Style (boite de dialogue 297 
COMDEF 

generation 65 
commandes 

aj outer aux menus 322 
ligne d'etat de l'editeur Bitmap 355 
raccourcis 324, 323 
ressource menu 
activer 323 
desactivees 323 
editer 322 
en grise 323 
identificateurs 325 
raccourcis 325 

raccourcis alignes a droite 325 
supprimer 326 
tabulations 325 
surgissantes 307 

ajouter aux menus 322 
commandes MAKE 
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regies 217 
commentaires 

dans les scripts ressource 244 

imbriques 65 

suppression d'une bibliotheque 205 
compilateur 

compilation par defaut des fichiers 48 

extensions de fichiers et compilation 48 

fichiers de configuration, priorite 48 

optimisations 81 

options 

par defaut 48 
desactiver 48 

regies de priorite des options 49 

table d'options 50 - 3-60 
compilateur 16bits 

description 47 
compilateur 32 bits 

description 47 
compilateur de ressource Microsoft 

Resource Workshop, incompatibilite 279 
compilateur en ligne 

description de BCC et BCC32 47 

macros, definition 62 

options, 

-f (emulation 80x87) 64 
emulation 80x87 (-f) 64 
compilateur en ligne de commande 

description 47 

TLINKet 171 
compilation par commande assembleur 90 
compilation 

erreurs 119 

regies 47 

table d'options 50 - 3-60 
Compile Now (commande) 318 
compiler les ressources 192 
conditionnel 

point d'arret 136 
configuration 

de l'EDI 10 

de l'editeur de l'EDI 13 

options 258 

raccourcis clavier 13 
consigner les expressions 136 



constantes 

visualiser 242 
CONTROL (instructions), generer 305 
Control (menu), boites de dialogue 266 
Control Type (options), boite de dialogue Static 
Style 295 - 15-296 
controles de boite de dialogue 

Ligne verticale en creux 471 

Bouton radio Borland 471 

Bouton-poussoir Borland 471 

Case a cocher Borland 471 

Groupe ombre 471 

Ligne horizontale en creux 471 

Texte statique 471 
controle de mise en garde, TLINK et 181 
controle de nom de segment 

options de compilateur en ligne de commande 72 
controles 263, 269 

affecter un identificateur de controle 278 

afficher la boite de dialogue Style 277 

aj outer 274 

des barres de defilement 278 
des libelles 279 

aligner 282 

avec une grille 277 

attributs communs 278 

barres de defilement 289 
vertical 272 

boite de saisie 292 

boites a options combinees 272, 297 

boites groupe 272 

boites liste 272, 290 

bordure 279 

boutons radio 271 

boutons-poussoirs 271 

BWCC270, 470 

case a cocher 272 

categories 269 

changer la taille 276 

coordonnees, definir 276 

definir l'ordre 281 

definition 269 

deplacer 276 

disposer en colonnes et rangees 284 

editer 277 
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edition texte 272 

en grise 279 

espaces regulierement 283 

grouper 279 

hauteur, specifier 276 

largeur, specifier 276 

modifier 277 

options communes aux boites Style 278 

options de style bouton 287 

palette Tools 270 

personnalises 270, 273, 279, 299 

proprietes 275 

rectangle noir 273 

redimensionner 285 

selectionner 273 
avec Tab 274 

statique texte 272 

statiques 294 

supplementaires, selectionner 274 

supprimer d'un groupe selectionne 274 

tester 301 

Windows 270 
controles boite de saisie 

allouer au segment local 267 

conversion texte OEM 299 

dans des boites a options combinees 297 
controles boutons 287 

Auto Check Box 287 

Auto Radio Button 288 

case a cocher 3-State 288 

case a cocher Auto 3-State 288 

Check Box 287 

Default Push Button 287 

Group Box 288 

justification du texte 288 

Owner Draw 288 

Push Button 287 

Radio Button 288 

User Button 288 

valeurs d'identificateur de controle 

predefinies 289 
controles BWCC 

bouton radio Borland 471 

bouton-poussoir Borland 471 

case a cocher Borland 471 



groupe ombre 471, 475 

ligne horizontale en creux 471 

ligne verticale en creux 471 

texte statique 471 
controles personnalises 

options de dessin 305 
controles statiques 272 

identificateurs de controle 278 
controles texte, distinction minuscule/majuscule 
293 
conventions d'appel 69, 77 

__cdecl 69, 77 

fastcall 69, 77 

pascal 69, 77 

C 69, 77 

de registre 69 

fastcall 63 

Pascal 69, 77 

Register 63, 69, 77 

standard 77 
conventions typographiques (documentation) 2 
conversions 

calculs flottants, regies ANSI 64 

pointeurs, suspects 87 
Convert OEM (option), boite de dialogue Edit Text 
Style 294 

Convert OEM option (Edit Text Style dialog box) 
299 
coordonnees en pixels 

curseurs 382 

ligne d'etat de l'editeur Bitmap 355 
coordonnees, specifier, controles 276 
copier une ressource entre projets 247 
copies (noeuds) 

police et 36 
copies de sauvegarde 259 
coprocesseurs numeriques 

emulation 64 

generation de code 64 
Copy (commande) 247 
couleurs 

curseurs 381 

de premier plan 346 

du texte dans l'editeur 14 

editeur Bitmap 356 
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editer 360 
fond 346, 357 
graphique par points 356 
icones 356 
index de palette 360 
inversees 382 
premier plan 346, 357 
transparentes 382 

icones 373 

mise en surbrillance de la syntaxe et 14 
couleurs inversees 

curseurs 357, 382 

icones 357, 372 
couleurs transparentes 357 

curseurs 357, 382 

icones 357, 372 
.CPP, fichiers 

compilation 48 
creer des fichiers identificateurs 252 
creer une boite de dialogue 263 
.CSM, fichiers 479 - C-480 

espace disque 481 

nom par defaut 480 

plus petit que prevu 481 
.CUR, fichiers 381 
curseur 

definition 234 

position affichee dans la barre d'etat 13 
Curseurs 379 

astuces et reserves 477 

couleurs inversees 357, 382 

couleurs transparentes 357, 382 

creer 380 

Edit Background Color (commande) 358 

Edit Foreground Color (commande) 358 

editer 381 

fichier .CUR autonome 380 

format binaire 380 

palette Colors 381 

point actif 382 

programmes Windows 379 

type de fichier .CUR 236 
CUSTCNTL.RW 299 
Custom (commande) 300 



-D (option BCC.EXE) 210 

definitions de macros 62 

fusion de chaines litterales 63 
Data Inspector (fenetre) 126, 131 
date et heure 

modification 209 
-de (option BCC.EXE) 

transfert des constantes chaines dans le 

segment de code 71 
debogage 

Voir aussi deboguer 

informations 121 

fichiers .EXE ou .OBJ 77 

option de compilateur en ligne 67 

TLINK 177 

numeros de ligne, .OBJ (fichiers) 67 

options de compilateur 67 

TLINK et 181 
deboguer 119 

assembleur 124 

code externe 124 

DLL 138 

fonctions membres 124 

recommencer au debut 126 

ressources menu 317 

tables de raccourcis 330 
debogueur integre 119 
Debug Information in OBJs 121 
Debug/Browse I Test stack overflow 67 
decalages bitmap (BWCC) 474 
Decompiler les ressources 236 
Default Push Button (controle) 287 
defaut 

options, desactiver 48 
#define 

options de compilateur en ligne 62 

options de compilateur en ligne de commande, 

separation 62 
Defines (EDI) 62 

Delete All Breakpoints (commande) 134 
Delete Breakpoint (commande) 134 
demarrage de TLINK (editeur de liens) 167 
dependances automatiques 

information, deactivation 65 
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emplacement (browsing) dans l'EDI Windows 

symboles globaux 18 
deplacer une boite de dialogue 265 
deroulant (menu) 308 
desactiver les commandes de menu 323 
Device Info (bouton-poussoir), boite de dialogue 
Icon Image Attributes 374 
DFA avec WinSpector 262 
DFA.OUT 262 
Dialog (editeur) 

composants de fenetre 264 

definir les preferences 304 

fenetre Caption 264 

lancer 263 

ligne d'etat 264 

unites de mesure 304 

modes 270 

options d'affichage 300, 304 

options Selection 305 

options Selection Border 304 

palette Alignment 264 

palette Tools 264 

personnaliser 304 
Dialog Frame (style de cadre), boites de dialogue 
266 
directives MAKE 223 

conditionnelles 225 
Directories (boite liste, boite de dialogue Open 
Project) 240 

Disabled (attribut de controle) 279 
Disabled (options), menus 313 
diviser la fenetre de l'editeur Bitmap 354 

annuler 354 
DLG Resource Script (entree) 302 
DLL 

bibliotheques d'import 197, 200 

classes 199 

deboguer 138 

fonctions d'export cachees 200 

noms non significatifs 200 

segments de code, stockage de 179 
documentation 

conventions typographiques 2 
Don't Redraw (option de style List Box) 292 
donnees 



ajouter a une ressource definie par 

l'utilisateur 398 
DOS 

ecrasement et editeur de liens 278 
DPMIMEM 22 

Draft (option d'affichage) 304 
Draw Custom Controls as Frames (preferences de 
l'editeur Dialog) 305 
Draw on Both Images (option) 366 
Drawing Type (options) 304 - 15-305 
Duplicate (commande), editeur Dialog 275 
Duplicate (outil) 275 



-e (option BCC.EXE) 277, 220 

assembleur a utiliser 92 

nom de programme EXE 92 
Easy Win 485 
ecrasement 

l'editeur de liens et 278 
EDI 

configuration 20 

groupement de plusieurs repertoires 62 

lancement 8 

macros, definition 62 

menus 9 

utilisation 5 
Edit (commande) 243 
Edit (volet de ClassExpert) 

description 208 
Edit as Text (commande) 243 
Edit Background Color (commande) 358 
Edit Foreground Color (commande) 358 
Edit Icon (bouton), boite de dialogue Static Style 

lancer l'editeur Bitmap 296 
Edit Image (commande) 373 
Edit Source (commande) 235 
Edit Text Style (boite de dialogue) 293 - 25-294 
editer 

boites de dialogue 264 

identificateurs 256 

menus 322 

ressources definies par l'utilisateur 397 

tables de chatnes 340 

tables de raccourcis 328 
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editeur 

ClassExpert et 108 
couleur du texte 14 
mise en surbrillance de la syntaxe 14 
mise en surbrillance du texte 14 
position du curseur sur les erreurs 15 
volet Edit et (ClassExpert) 109 
editeur Bitmap 345 

aligner la zone selectionnee 365 
BG dans la palette Colors 346 
coordonnees en pixels 

curseurs 382 

ligne d'etat 355 
couleurs 356 

bitmaps 356 

icones 356 
dilater les zones selectionnees 365 
explications de commandes (ligne d'etat) 355 
FB dans la palette Colors 346 
fenetres 354 

FG dans la palette Colors 346 
forme de pinceau 363 
index de palette 355 
informations d'outil (ligne d'etat) 355 
informations de couleurs (ligne d'etat) 355 
lancer 296, 345 
ligne d'etat 355 
motifs 363 
options globales 366 
outils 346 

Aerographe 350 

Boite de peinture 350 

Ciseaux 348 

Ellipse, cadre plein 353 

Ellipse, cadre vide 352 

Gomme 349 

Ligne 351 

Main 353 

Pinceau 350 

Rectangle de selection 348 

Rectangle, cadre plein 353 

Rectangle, cadre vide 352 

Stylo 349 

Texte 352 

Zoom 348 



palette Colors, index 360 

palette Tools 346 

Rectangle arrondi, cadre plein 353 

Rectangle arrondi, cadre vide 352 

redimensionner les zones selectionnees 365 

selectionner les outils 346 

selections de style 354 

styles de ligne 364 

texte 352, 361 

types de ressources edites 345 

valeurs RGB 359 
definir 360 
ligne d'etat 355 

volet de fenetre actif 354 

vues multiples 354 
editeur Brief 

emulation 13 
editeur de texte 

ressources definies par l'utilisateur 397 

touches 399 
editeur de texte externe 241 

selectionner 244 

utiliser 244 
editeur de texte interne 243 

commande Compile Now 318 
editeur Dialog 

option Parent Notify 472 
editeur Epsilon 

emulation 13 
editeur Notepad (Windows) 244 
editeur String 335 

activer 336 

champs 340 

illustration 337 

lancer 336 
editeurs 

selectionner 244 
editeurs de ressources 235 

Accelerator 323 

Bitmap 345 

Cursor 379 

Font 385 

Icon 369 

String 335 

lancer (boite de dialogue Identifiers) 257 
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Menu 307 

ressources definies par l'utilisateur 395 
edition de liens 

compilateur de lignes de commande et 171 

modules non-C et 178 

options 

a partir du compilateur en ligne 91 

de compilateur en ligne de commande 91 

tableau 173 

table complete 91 

table de liaison, creation 91 
edition texte (controle boite de dialogue) 272 
Editor Options (commande), editeur Bitmap) 366 
ef facer un point d'arret 133 

EGA/VGA Resolution (commande), editeur Icon 
372 
elements 

mise en surbrillance de la syntaxe 14 
elements de donnees 

inspecter 131 

modifier la valeur 131 
elements de menu 308 

aj outer 312 

selectionner 311 
!elif (directive MAKE) 223, 225 
Ellipse 

cadre plein 353 

cadre vide 352 
!else (directive MAKE) 223, 225 
EM_SETHANDLE/EM_GETHANDLE (messages) 
267 

emulation 80x87 64 
en-tetes, fichiers 252 
en-tetes (polices) 392 
en-tetes precompiles 

controle 480 

fonctions membres inline 480 

inconvenients 480 

optimisation 482 

options en ligne de commande 68 

regies 481 
Enabled (option), menus 313 
EnableMenuItem (fonction) 313 
lendif (directive MAKE) 223, 225 
enfant 



de la fenetre active 266 
enregistrement 

fenetres de l'EDI et 12 
enregistrer 

ressources 258 
entiers 68 

alignes sur une limite de mot 68 
enumerations (enum) 

attribution d'entiers 87 

traitees en tant qu'entiers 63 
Environment Options (boite de dialogue) 

preferences 12 
Epsilon 

raccourcis clavier de l'editeur 13 
erreur de protection generale 137 
erreurs 119 

a la compilation (syntaxe) 119 

compilation (syntaxe), causes les plus frequentes 

220 

dans le code 15 

a l'execution (semantique), causes 220 

fenetre de messages, recherche 15 

limiter l'affichage 220 

localiser 229 

logique 220 

option de rapport du compilateur en ligne de 
commande 87 

types 229 

violations ANSI 87 
erreurs a la compilation 

causes les plus frequentes 220 

dans le code 25 

definition 229 
erreurs de logique 

definition 220 
lerror (directive MAKE 223 

description 224 
ES_READONLY (style) 294 
ES_WANTRETURN (style) 294 
espace disque sature 482 
estompes 

boutons de la barre d'icones 9 
Evaluate Expression (boite de dialogue) 226 
Evaluate /Modify (boite de dialogue) 229 
evaluer une expression 229 
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evenements 

enumeration dans ClassExpert 108 
Event Log (fenetre) 136 
Events (volet de ClassExpert) 

description 108 
.EXE (fichiers), TLINK et 181 
execution 

en mode pas a pas 122 

erreurs, definition 120 

erreurs,causes 120 
expressions 126 

consigner 136 

definition 126 

evaluer 129 

formatage 129 

suivi 127 

suivre 129 
expressions booleennes 

condition de point d' arret 136 
expressions de suivi 

activer 129 

desactiver 129 

modifier le format d'affichage 127 

modifier les proprietes 129 

supprimer 129 
Extend Select (option de style List Box) 292 
extensions 

compilateur 48 
extensions de fichier 

fournies par TLINK 169 
extensions pour mise en surbrillance de la syntaxe 

ajout 14 
extraire et sypprimer (action TLIB) 206 



-f (option BCC) 177, 210 

emulation 80x87 64 
Fl (touche) 10 
_ _f astcall 77 

convention d'appel 69 

option en ligne de commande 69, 77 
fastthis 

convention d'appel 63 

option en ligne de commande 63 
FB dans la palette Colors 346 



-Fc (option BCC) 

generation de COMDEF 65 
fenetre de messages 

recherche automatique d'erreur 15 

utilisation 15 
fenetre projet 241 

contenu 241 

options d'affichage 242 

ressources, selectionner 243 
fenetres 

dans l'EDI, limite imposee par la memoire 

disponible 13 

editeur Bitmap 354 
fenetres Browser 

utilisation 16 
fenetres d'edition 

configuration 13 
fenetres de l'EDI 

modification 13 
fenetres enfant 

proteger la zone client 267 
fenetres superposees 

boites de dialogue 266 
fenetres surgissantes 

boites de dialogue 266 
-ff (option BCC. EXE) 

calculs flottants rapides 64 

variables globales far 71 
FG dans la palette Colors 346 
fichier 226 

.DRV 236 
fichier DLL 236 
fichier executable 236 
fichier MAKE 

designation 210 
fichier projet .FNT 388 
fichier projet .ICO 371 
fichier ressources 

definition 235 
fichiers 

.BMP 236 

.CUR 236 

.DLG236, 302 

.FNT 237 

.FON 237 
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.H252 

.ICO 236 

.RES, enregistrer les ressources 259 

.RES, identificateurs 251 

changement de la date et de l'heure 209 

compilation 92 
C ou C++ 48 

copies de sauvegarde 259 

crees par AppExpert 96 

en-tete 252 

extensions 169 

et compilateur 48 

identificateur 

ajouter aux projets 252 
langage C 252 

mise en surbrillance de la syntaxe 14 

recherche 169 

visualisation a partir de ClassExpert 108 
fichiers .COM, TLINK et 180 
fichiers include utilisateur 60 
fichiers mappe 91 
fichiers .RSP 

definition 49 
fichiers d'en-tete 

recherche 61 
fichiers de configuration 

compilateur en ligne de commande 48 

compilateur en ligne, priorite 49 

compilateur en ligne, regies de priorite 49 

priorite 48 

TURBOC.CFG 48 
fichiers de definition de modules 

description 183 

difference majuscules/minuscules et 176 

NAME absent 188 

TLINK et 183 

/Tw option TLINK et 181 
fichiers de mappe 

debogage 178 

generes par TLINK 178 
fichiers de recherche 

definis pour BCC.EXE 49 

definis pour TLINK 170 

et MAKE 219 

priorite 49 



TLINK et 170 
fichiers DLL 

editer les ressources 260 

installer 300 
fichiers en ligne 

BWCCAPI.RW 469 

BWCCSTYL.RW 469 

CUSTCNTL.RW 299 
fichiers executables 

editer les ressources 259 

enregistrer lesressources 258 

identificateurs 251 
fichiers include 

options de compilateur en ligne de commande 61 

recherche 61 

repertoires 60 
fichiers MAKE 

commandes 215 

continuation de ligne 215 

debogage 219 

option KEEP 211 

option NOKEEP 212 

regies implicites 215 
filtres 

Browser de Windows 17 
fixe, largeur de police 389 
Fixed (option Owner Drawing 290 
Floating Point (option) 128 
-Fm (option BCC) 

activation des options -F 91 
.FNT, fichiers 

creer de nouvelles polices 388 
.FON, fichiers 

creer 394 
fonctions 

conventions d'appel 69, 77 

enumeration dans ClassExpert 108 

inline avec les en-tetes precompiled C++] 480 

le Browser sous Windows 18 

recherche d'une fonction 125 

vide, production d'une valeur vide 87 
fonctions membres 

deboguer 124 
fonctions virtuelles 
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membres caches dans les classes derivees avec 

pointeurs 79 
fond (couleurs) 346, 357 
Font (commande) 362 
Font Size (commande) 389 
Font Version (option), en-tetes de police 393 
format binaire 

curseurs 380 

icones 370 

polices 237, 387 
format source 

icones 370 

polices 387 
formatage 

expressions de suivi 127 

expressions 229 
-Fs (option BCC) 

DS = SS suppose 71 



/Gx option TLINK 177 
generate, bouton 97 
generation de code 

options de compilateur en ligne de commande 63 

resultats 16 bits 47 

resultats 32 bits 47 
gestion d'exceptions 

option de compilateur 80 
gestionnaire de fichiers 

utilisation dans un projet (noeuds) 34 
gestionnaire de projet 

installation de traducteurs 42 

noeuds dependants et 28 

noeuds 

"tirer et lacher" 34 
ajout 34 
gestionnaires 

ajout (ClassExpert) 112 

suppression (ClassExpert) 112 
gestionnaires de visualisation 

Resource Workshop et 114 
gn (option BCC. EXE) 

interruption sur n avertissements 87 
Gomme 349 

affectations de couleurs 357 



affectations des couleurs 346 

options de couleur 349 
Groupe ombre 471 
GP 

type d'erreur 137 
graphiques par points 

definition 234 

options de couleurs 356 

Voir aussi Bitmaps 
Gray Frame (type de controle statique) 296 
Gray Rectangle (type de controle statique) 296 
Grayed (option), menus 313 
Grid (commande) 277 
Grid on zoomed windows (option) 367 
grille 

afficher 277 

aligner les controles 277 
grise (controles 279 
griser les commandes de menu 313 
Group (attribut de controle) 279 
Group Box (controle) 288 
grouper des controles 279 
groupes (controles boite de dialogue) 281 

et selections multiples 281 

H 

-H (option BCC.EXE) 

en-tetes precompiled 68 

pointeurs fast huge 72 
hard (mode de debogage) 139 
Has Strings (option de style List Box) 292 
hdrfile, pragma 480 - C-481 
hdrstop, pragma 480, 483 
Header (commande) 392 
Help Break (option) 313 
Hide Palette (commande) 359 
Home Budget (icone) 375 

Horizontal Scroll (style), boites de dialogue 267 
.HPJ (fichiers) 

creation 96 



I 



-I (option BCC.EXE) 177, 210 
longueur d'identificateur 65 
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repertoire de fichiers include 60 
Icon Image Attributes (boite de dialogue) 374 
.ICO, fichiers 

creer de nouvelles icones 371 

a trois dimensions 376 
icones 369 

afficher des informations peripheriques 374 

astuces et reserves 477 

CGA Resolution (commande) 372 

changer la resolution 374 

changer les attributs 374 

controles statiques dans les boites de dialogue 297 

couleurs inversees 357, 372 

couleurs transparentes 357, 372 

creer 369, 375 

trois dimensions 376 

definition 234 

dessiner, calcula trice 375 

Edit Background Color (commande) 358 

Edit Foreground Color (commande) 358 

editer 371 

effacer 376 

EGA/VGA Resolution (commande) 372 

fenetres reduites 369 

fichier .ICO autonome 371 

format binaire 370 

format source 370 

images multiples, ajouter 372 

images, ajouter 372 

options d'affichage 373 

options de couleur 356, 373 

projet exemple 375 

type de fichier .ICO 236 

utilisees dans la documentation 2 
identificateur d'element (menus) 313, 315, 317 
identificateur de controle 

option Style 278 

valeurs Windows predefinies, boutons-poussoirs 

288 

valeurs BWCC predefinies de WORD 473 
identificateurs 250 

ajout automatique 253 

ajouter 254 

annulation 93 

caracteres de soulignement 65 



commandes menu 313 

composants 250 

controles statiques icone 297 

creation automatique 253 

de chaines 338 

de controle 278 

de ressource 250 

deplacer 256 

editer 256 

et raccourcis 329 

fichiers 252 

fichiers executables et ressources compilees 252 

lancer un editeur ressource 257 

liste 257 

longueur significative 63, 65 

macro MAKEINTRESOURCE 251 

menus 315 

modifier la valeur 252 

raccourcis 326 

renommer 256 

ressources definies par l'utilisateur 396 

stacker 252 

suppression automatique 253 

supprimer 256 

tables de chaines 337 - 18-338 

touches virtuelles 324 

transtyper 251 

type MakelntResource 252 

unique dans un type de ressource 252 

verifier les doublons, menus 327 

verifier les doublons, raccourcis 330 

visualiser 242 
Identifiers (boite de dialogue) 

ajouter des identificateurs 255 
!if (directive MAKE) 223, 225 
lifdef (directive MAKE) 223, 225 
lifndef (directive MAKE) 223, 225 
ignore (directive MAKE) 223 
images bitmap 

ajouter du texte 352 

couleurs 
fond 346 
premier plan 346 

effacer 349 

pixels 346 
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remplir de couleur 350 

selectionner des zones irregulieres 348 

selectionner des zones rectangulaires 348 

selections de style 354 

texte 361 

voir, vues multiples 354 

zoomer 348 
images zoomees 348 

outil Aerographe 350 

outil Pinceau 350 
#include (directive) 223 

crochets angulaires () 61 

description 226 

guillemets 61 
index de palette 355 
indicateur Want Return (BWCC) 473 
informations de debogage 121 
Initial State (options), menus 313 
inspecter 

elements de donnees 232 
Install Control Library (commande) 300 
instructions 80286 

16 bits 68 
instructions 80386 

16 bits 68 

32 bits 76 
instructions 80486 

16 bits 68 

32 bits 76 
instructions dans le volet Outline 320 
instructions Pentium 

32 bits 76 
Integral Height (option de style Boite a options 
combinees) 299 

Integral Height (option de style List Box) 292 
Intel 

definition des champs ACBP 279 
interface graphique GDI 395 
interface utilisateur, personnaliser 260 
interrompre un programme 226 
Invalid Breakpoints (boite de dialogue) 235 
inverser les elements de menu 330 
Invert Menu Item (option), editeur Accelerator 330 



-Jg (options BCC.EXE) 

options de generation de modeles 80 
jeu de caracteres ANSI 294, 299 

correspondance avec les polices 390 
jeux de caracteres 

correspondance avec les polices 390 

definition 389 
jeux de commandes 

utilisation de l'EDI 23 
-jn (option BCC.EXE) 

interruption sur n erreurs 87 
journaliser 

Voir consigner 

K 

s-K (option BCC.EXE) 220 

,caracteres non signes 63 

cadre de pile standard 66 
KEEP (option MAKE) 222 
Keep Selection (option), boite de dialogue Edit 
Text Style 294 
Kernighan et Ritchie 

mots-cles 66 
Key (option), menus 324 
Key Type (option), menus 324 
Key Value (commande), editeur Accelerator 330 
Key Value (mode), editeur Accelerator 327 



-L (option BCC.EXE) 277 

options d'editeur de liens 92 

code objet et repertoire de bibliotheque 60 
lancement d'autres programmes 23 
lancement de Borland C++ 8 
lancer les editeurs ressource 

Accelerator 325 

Bitmap 345 

Dialog 263 

Menu 308 

String 336 
langage assembleur 

compilation 90 

fichiers de sortie 92 



Index 



505 



options 

suppression 92 
passage 92 

procedures en ligne 90 

repertoire 60 
langage C 

# define 252 

fichiers en-tete 252 

sequences d'echappement 339 
LB_ADDSTRING (message) 292 
LB_GETTEXT (message) 292, 298 
LBJNSERTSTRING (message) 292 
LB_SETCOLUMNWIDTH (message) 291 
LB_SETTABSTOPS (message) 291 
LB_SETTEXT (message) 298 
LBS_DISABLENOSCROLL (style) 292 
.LIB (fichiers) 

BCC 48 
libelle, aj outer 

a une boite de dialogue 266 

aux controles 279 
librairies 

Voir bibliotheques 
Ligne 352, 382 

options de couleur 351 

styles 364 
Ligne horizontale en creux 471 
Ligne verticale en creux 471 
ligne d'etat 

editeur Bitmap 355 

editeur Dialog 264, 304 
lignes 

droites 351 

numeration, dans les fichiers objets 67 

numerotation dans TLINK 177 

atteindre 9 
lignes en creux verticales et horizontales (BWCC) 
475 

lignes en relief verticales et horizontales (BWCC) 
475 

Line (options), boite de dialogue Edit Text Style 
293 

List Box Style (options de boite de dialogue) 290 
ListClasses (fonction) 270 
liste d'arguments de variables 77 



liste de classes 143 
listes multiples 

options de compilateur en ligne de commande, 

#define 62 

options de compilateur en ligne de commande, 

definition de macros 62 

options de compilateur en ligne de commande, 

include et 61 
Load on Call (option memoire) 249 
Load Symbol Table (commande) 139 
LOADBWCC.EXE 476 
Local Edit (style), boites de dialogue 267 
Locate Function (commande de menu) 125 

M 

-M (option BCC.EXE) 

table de liaison 91 
macros 

definition 62 
Main 353 

Maj-clic (technique de selection) 273 
majuscules/minuscules 203 

TLINK 176 

TLINK32 176 

TLINKfichiers de definition de modules et 176 
MAKE 

aide sur la ligne de commande 208 

annuler les definitions de macro 210 

arreter 208 

auto-dependance 223 

build force 209 

BUILTINS.MAK 208 
description 208 
ignorer les regies 209 

changer le repertoire utilise 210 

cibles multiples 213 

cibles symboliques 213 
regies 213 

commandes 215 

compatibilite avec NMAKE 211 

composants, :: (plusieurs regies explicites) 215 

controles d'erreur 224 

creer les cibles 213 

creer toutes les cibles 210 

debogage219 



506 



Borland C++ Guide de I'utilisateur 



definition 207 
definition de macros 210 
dependance liee 208 
desactiver l'affichage 211 
description 207 
directives 223 

!error 223 

!include 223 

liste 223 

Imessage 223 

!undef224 

.path.ext 224 

.precious 224 

regies conditionnelles 225 

.suffixes 224 

utilisation de macros 224 
erreurs 403 

etat de sortie des programme 220 
fichier MAKEFILE 207 
fichiers MAKE 

nom different 220 
fichiers temporaires 

conserver 210, 211 

utilises pour le debogage 219 
fichiers, affichage de la date et de l'heure 209 
ignorer l'etat de sortie des programmes 210 
instructions 212 
KEEP (option) 211 
macros 

$d (tester) 229 

definir 220 

definition 220 

ligne de commande ou fichier MAKE 221 

liste de modificateurs 222 

modifier 222 

nom de fichier 221 

par defaut (description) 222 

par defaut (modifier) 209 

substitution de chaines 221 

syntaxe 220 

texte a utiliser 220 

utiliser 221 

vides 229 
memoire cache et auto-dependance 210 
modificateurs de commande 217 



& (expansion macro) 217 

- (traitement codes d'erreur) 217 

@ (inhiber la sortie) 227 
NMAKE, compatibilite 221 
NOKEEP (option) 212 
noms de macros, parentheses 221 
operateurs conditionnels 226 
operateurs de commande, liste 218 
operateurs en ligne de commande, && (creer 
fichier temporaire) 219 
options par defaut 210 
prefixes de commande 217 
regies explicites 214 

plusieurs 215 

sans commandes 215 

syntaxe 214 
regies implicites 213 

syntaxe 216 

utilisees avec des regies explicites 216 
regies par defaut 207 
regies sur les commandes 217 

format 213 

ignorer 211 
selectionner les options par defaut 210 
SHARE, incompatibilite 211 
sortir de la memoire 211 
supprimer l'affichage 211 
syntaxe 208 
taches par defaut 208 
texte a utiliser dans les macros 220 
TOUCH.EXE 209 
utiliser des fichiers MAKE 210 
variables d'environnement 210 
MAKEFILE 

utilisation 212 
MAKEINTRESOURCE (macro) 251 
MakelntResource (type) 251 
MAKEREXE 
definition 207 
memoire 211 
MAKESWAP.EXE 21 
Manual (mode), editeur Accelerator 330 
Maximize Box (style), boites de dialogue 267 
memoire 

effet sur l'option Undo Levels 258 
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et outils 32 bits en ligne de commande 21 
options 248 
ressources bitmap 387 
memoire etendue 

TLINKetl82 
memoire insuffisante 
et outils 32 bits 21 
memoire paginee 

TLINKetl82 
Memory Options (commande) 248 
Menu (editeur) 307 

commande View as Pop-up 310 
composants de l'ecran 309 
definir l'affichage Test Menu 310 
editer les elements de menu 312 
lancer 308 
options 

Break Before 313 
Checked 313 
Disabled 313 
Enabled 313 
Grayed 313 
Help Break 313 
Item Help 313 
Item ID 313 
Item Text 313 
Item Type 313 
Key 314 
Key Type 314 
Menu Bar Break 313 
Menu Break 313 
Modifiers 314 
No Break 313 
utiliser avec l'editeur Accelerator 325 
volet Attribute 309 
volet Outline 310 
volet Test Menu 309 
volets 309 
Menu Bar Break (option), menus 313 
Menu Break (option), menus 313 
menu d'exemple 319 
menu Widgets 
creer 319 

raccourcis, creer 331 
Menu I Track test (menu) 317 



menus 307 

activer des commandes 313 
afficher 

en menu flottant 310 

les valeurs d'identificateurs 317 
aj outer 

a une boite de dialogue 268 

commandes 312 

commandes surgissantes 312 

instructions 311 

raccourcis 315 

separateurs 312 
astuces et reserves 478 
clignoter 330 
commandes 307 

lier aux raccourcis 329 

tabulations 315 
copier des instructions 315 
creer 308 
deboguer 317 

deplacer des instructions 315 
deroulants 308 

desactiver des commandes 313 
editer 311 

elements de menu 312 

script ressource 318 
Voir aussi elements de menu 
en cascade 307 
exemple 319 
flottants 308 

creer 316 

tester 310 
griser des commandes 313 
Help Break dans barre menu 313 
identificateurs 315 
instructions 310 

supprimer 316 
inversion video 330 
options memoire 318 

rechercher les identificateurs d'element en double 
317 

script ressource 318 
separateurs 308 
souligner des caracteres 314 
supprimer des commandes surgissantes 316 
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surgissants 308 

tester 309, 317 

affichage surgissant 310 

touches de raccourci 323 
menus flottants 

creer 316 
menus locaux 

ouverture 9 
Message (fenetre) 

afficher les erreurs et les avertissements 119 
Messages I General 90 
Messages I Inefficient C++ Coding 89 
Messages I Inefficient Coding 89 
Messages I Obsolete C++ 88 
Messages I Potential C++ Errors 88 - 3-89 
messages d'erreur 403 

definition 404 

erreur fatale 403 

dans les tables de chaines 335 
messages d'invite, dans les tables de chaines 335 
messages de mise en garde 403 

definition 404 
metafichiers 395 

Minimize Box (style), boites de dialogue 267 
mise en couleur du texte 14 
mise en surbrillance de la syntaxe 

ajout de fichiers 14 

deactivation 14 

modification 14 

utilisation 14 
mise en surbrillance du texte 14 
mises en garde 

Voir aussi avertissements 

generales 90 
Modal Frame (style), boites de dialogue 267 
mode 

hard 139 

soft 139 
mode de selection 273 
mode pas a pas 

definition 122 
modele Tiny 

fichiers .COM et 180 
modeles 

generation 80 



modeles de memoire 

options en ligne de commande 70 
modes (editeur Dialog) 270 

selectionner 273 

test 301 
modifier 

point d'arret 136 

proprietes d'un point d'arret 135 

valeur des elements de donnees 131 

valeurs de variables 130 

valeur d'un identificateur 252 
Modifiers (option), menus 314 
motifs 

outil Aerographe 350 

outil Pinceau 350 

outils de cadre plein 353 

selectionner 363 
mots cles 

Borland C++ 66 

d'extension ANSI 66 

Kernighan et Ritchie, utilisation 66 

UNIX, utilisation 66 
Move resource (boite de dialogue) 247 
Moveable (option memoire) 249 
Multi Column (option de style List Box) 292 
Multi-Save (boite de dialogue File Preferences) 
258, 260 

Multiple Select (option de style List Box) 292 
-mx (options) 

modeles de memoire 70 

N 

-n (option BCC.EXE) 278, 220 

logique de debordement de pile 67 

repertoires .OBJ et ASM 60 
New (commande), Resource (menu) 245 
New button (boite de dialogueldentifiers) 255 
New Edit Pop-up (commande), editeur Menu 322 
New File Pop-up (commande), editeur Menu 322 
New Help Pop-up (commande), editeur Menu 322 
New Image (commande) 373 
New Menu Item (commande), editeur Menu 322 
New Pop-up (commande), editeur Menu 322 
New Project (boite de dialogue) 239 
New Project (commande) 239 
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New Resource Type (boite de dialogue) 396 
New Separator (commande), editeur Menu 322 
NMAKE (Microsoft) 

remplace par MAKE 210 
No Border (style de cadre), boites de dialogue 266 
No Break (option), menus 313 
No Idle Messages (style), boites de dialogue 267 
noeuds 

ajout par "tirer et lacher" 34 

dependants 28 

police maigre (copie) 36 
.nolgnore (directive MAKE) 223 
NOKEEP (option MAKE) 222 
nombre de passages 

a un point d'arret 136 
NomDeMacro 227 
noms non significatifs 

DLL 200 
Normal (option d'affichage) 304 
.nosilent (directive MAKE) 223 
.noswap (directive MAKE) 223 
Not Owner Draw (option Owner Drawing) 290 
NOT WS_VISIBLE (style) 279 
Notify (option de style List Box) 292 
numeros de ligne 

dans la barre d'etat 23 



-o (optionBCC.EXE) 278 

fichiers objet 92 
.OBJ (fichiers) 

BBC 48 

compilation 92 

numeros de ligne 67 

repertoires 60 
ObjectWindows 

applications AppExpert 95 

classes, visualisation 207 

creation d'applications 96 
objets 

hierarchie, visualisation 27 

Browser, dans l'EDI Windows 27 

voir les details 18 
octal (format), specificateurs 399 
OEM (jeu de caracteres) 294, 299 



ombre portee 376 - 20-377 

Open Project (boite de dialogue) 240 

Open Project (commande) 240 

optimisations 

EDI 81 

en-tetes precompiled 482 

options de compilateur en ligne de commande 82 

registres, utilisation 64 
Option Browser reference information in OBJs 26 
Option Debug information in OBJs 26 
Option Defpushbutton (BWCC) 473 
option owner-draw (BWCC) 472 
options 

BCC.EXE 47 

compatibilite ascendante 93 

compilateur, table 50 - 3-60 

editeur de l'EDI 23 

generation de modeles C++, option en ligne de 
commande 80 

insertion dans les fichiers 49 

priorite 49 

projet, modification 30 

TLINK, tableau 273 
Options I Save 22 
options de compilateur 

regies 49 
options de couleur 

Aerographe 350 

Boite de peinture 350 

Gomme 349 

Ligne 352 

Pinceau 350 

Stylo 349 

Texte 352 

cadre vide 352 

cadre plein 353 
options en ligne de commande 

insertion dans les fichiers 49 
options MAKE 

aide 220 

liste 220 

-N (compatibilite NMAKE) 220 

utilisation 220 
Options Settings (boite de dialogue) 20 
options TLINK 
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tableau 173 
ordre d'evaluation 

options de compilateur en ligne 49 
outil texte 

options de couleur 352 
Outil Texte static Borland 471 
outils 

editeur Bitmap 348 

editeur Bitmap, selectionner 346 

editeur Dialog 270 
Outline (volet), editeur Accelerator 326 
Outline (volet), editeur Menu) 310 
ouvrir un projet 240 
Overlapped 

style de fenetre 266 
Owner Draw (controle bouton 288 
Owner Drawing (options) 

boites a options combinees 298 

boites liste 290 - 25-291 



-p (optionBCC.EXE) 179, 211 

compilations C++ et C 92 

conventions d'appel Pascal 69, 77 
-p- (option BCC.EXE) 

conventions stdcall 69 

pages, alignement 176 
palette Colors 356 

afficher 359 

cacher 359 

index 360 

montrer 359 
palettes 

Colors, index 360 

couleurs 356 

Tools (editeur Bitmap) 346 

Tools (editeur Dialog) 270 
palettes couleur, personnalisees 367 
palettes couleur, personnaliser 360 
parametre d'alignement de mot 68, 76 
parametres 

alignement de mot 68, 76 
pas a pas 

definition 122 



_pascal 69, 77 



option en ligne de commande 69, 77 
Pass Keyboard Input (option de style List Box) 292 
passages 

nombre 236 
Password (option), boite de dialogue Edit Text 
Style 294 

Paste (commande) 247 
.path.ext (directive MAKE) 224 

description 227 
Pattern (commande) 364 
Pause Program (commande) 226 
-pc (option BCC.EXE) 

conventions C 69, 77 
Pen Style (boite de dialogue) 364 
Pen Style (commande) 364 
pile 

cadrere standard, generation 66 

debordement 67 
pilotes video, couleur 356 
Pinceau 350 

forme de pinceau, choisir 363 

motifs 363 

options de couleur 350 
pixels 346 

unite de mesure dans l'editeur Dialog 304 
-po (option BCC.EXE) 

convention d'appel fastthis 63 
point actif 

definir 382 
point d'execution 222 

personnaliser l'affichage 237 

saut au 225 
pointeur d'instruction 225 
pointeurs 

conversion suspecte 87 

fast huge 72 

huge 72 

table virtuelle, 32 bits 72 
compatibilite 79 
pointeurs membres 

controle 77 
points d'arret 233 

activer 234 

conditionnels 236 

Voir aussi debogage, expressions de suivi 
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definition 133 

desactiver 134 

effacer 133 

incorrects 135 

modifier 136 

modifier les proprietes 135 

personnaliser l'affichage 137 

poser 133 

apres le lancement du programme 136 

dans un fichier non ouvert 136 
supprimer 134 
polices 237, 385 

Attributes (options) 393 
attributs, definir 393 
bitmap, definir la largeur 391 
caracteres 

definir la largeur 391 

ajouter 390 
contenu de l'en-tete 392 

correspondance avec les jeux de caracteres 390 
creer 387 

definition 234, 385 
description 392 
editer 389 

fichier .FNT autonome 388 
format binaire 387 
format source 387 

graphiques par points, multiples, stacker 386 
image, definir la largeur 391 
informations de copyright 392 
jeux de caracteres, definir 389 
largeur fixe 389 
largeur variable 389 

creer 391 
noeuds et 36 

nombre de caracteres, definir 390 
options 

Average Width 390 

Break 391 

Copyright 393 

Default 391 

Device 393 

Face Name 393 

Height 390 

Last 391 



Stretch Current Chars 390 
Character 391 

specifier pour une boite de dialogue 268 

taille, definir 389 

trainees 386 

utilisation dans les applications 394 

vectorielles 386 
POPUP (instruction) 

supprimer 316 
Popup, style de fenetre 266 
portage 

options 66 
portee des elements de donnees affiches 131 
poser un point d'arret 133 

apres le debut de l'execution 136 
-pr (option BCC.EXE) 

convention d'appel fastcall 69, 77 

#pragma (options) 

warn 87 
#pragma hdrfile 480 - C-481 
#pragma hdrstop 480, 483 
pragma intrinsic 84 
.precious (directive MAKE) 

description 224, 227 
preferences 

definition 12 

menu File 258 

Multi-Save 260 
Preferences (boite de dialogue, editeur Dialog 304 
Preferences (commande), editeur Dialog 304 
Preferences (commande), menu File) 258 
Preferences (editeur Dialog) 

Draw Custom Controls as Frames 305 

Drawing Type 304 - 15-305 

Generate CONTROL Statements Only 305 

options Selection 305 

Selection Border 304 

unites de la ligne d'etat 304 
Preload (option memoire) 249 
premier plan (couleurs) 357 
presse-papiers 

copier une ressource 247 
priorite 

options de compilateur en ligne 49 
problemes de remplissage, images bitmaps 351 
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processeurs 80x86 

instructions 68 

instructions 32 bits 76 
programmes 16 bits DPMI 

incidents 21 
projets 239 

ajouter une ressource 244 

copier une ressource entre 247 

creer 239 

enregistrer 302 

mise en surbrillance de la syntaxe 14 

options, modification 30 

ouvrir 240 

polices et noeuds 36 

ressources definies par l'utilisateur, ajouter 397 

ressources integrees, ajouter 245 

ressources liees, ajouter 245 

types de fichier, choisir 239 
projets d'exemple 

icone 375 

raccourcis 331 

tables de chalnes 341 

Q 

-q (option MAKE) 211 



-r (option BCC) 211 

addition d'informations browser 67 

etBUILTiNS.MAK208 

variables de registre 64 

et DLL 139 
raccourcis 234, 323 

ajouter 315 

commandes 314 

creer 325 

deboguer 330 

definition 323 

editer 328 

exemple 331 

fonction Flash 330 

identificateurs 326 

rechercher les identificateurs en double 330 

selectionner 328 



tabulations 315 

touches ASCII 324 

touches virtuelles 324 

Windows predefinis 329 
raccourcis clavier 

configuration 13 
RC 191 

RCJNVOKED 193 
RCDATA (type de ressource) 401 
rcinclude (reference) 302 
s-rd (option de compilateur) 64 
Read Only (option), boite de dialogue Edit Text 
Style 294 
recherche 

automatique d'erreur 15 

de bibliotheques 61 

de fichiers include 61 

d'une fonction 125 
recreation de bibliotheques 65 
Rectangle 

cadre plein 353 
couleurs 353 
motifs 353, 363 

cadre vide 352 
couleurs 352 
styles de ligne 364 
rectangle de selection 273 

outil 348 
rectangle noir (controle boite de dialogue) 273 
redimensionner des zones selectionnees (editeur 
Bitmap) 365 

redimensionner une boite de dialogue 265 
Redo Levels (boite de dialogue File Preferences) 
258 
Register 

convention d'appel 77 

conventions d'appel 63 
Register Keyword 

option de compilateur 64 
Registers (fenetre) 132 
registres 132 

variables 

bascule 64 
explicites 64 
mot cle 64 
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suppression 64 
Relative (option de grille), boites de dialogue) 277 
relief 

boites de dialogue avec Resource Workshop 306 
remplacer (action TLIB) 206 
Rename (commande) 248 
renommer 

ressources 248 
Repeat Count (option) 128 
repertoires 

bibliotheques 61 

option en ligne de commande 60 

ASM et .OBJ, options en ligne de commande 60 

fichiers include 60 
Resource Workshop 

a partir de l'EDI 114 

AppExpert et 114 

ClassExpert et 115 

compilateur de ressource Microsoft, 

incompatibilite 279 

configurer 258 

modifications avec AppExpert et 115 

preferences 258 
Resource I Move 247 
ressource RC 

definition 235 
ressource utilisateur 

definition 235 
ressource VERSIONINFO 

definition 235 
ressources 292, 239 

ajouter au projet 244 

charger 243 

compiler 192, 236 

copier entre projets 247 

creer, nouveaux types 396 

decompiler 236 

definies par l'utilisateur 395 
ajouter au projet 397 
editer 397 
metafichiers 395 

definition 233 

deplacer 247 

editer dans les fichiers executables et DLL 260 

editeurs 235 



edition de liens 193 

enregistrer, boite de dialogue File Preferences 260 

identificateurs 250 

integrees 241 

integrees au projet 245 

liees 241 

lier 236 

lier au projet 245 

menus 307 

noms par def aut 250 

options d'affichage 242 

options memoire 248 

polices et graphiques par points 386 

raccourcis 323 

RCDATA 401 

renommer 248 

selectionner 243 

types 233 

types de fichiers 235 
ressources bitmap 

memoire 387 

polices et graphiques par points 386 

types 345 
ressources definies par l'utilisateur 

chaines, terminees par un zero 400 

donnees, ajouter 398 

formats de donnees 399 

identificateurs 396 

valeurs hexadecimales 400 
retablir258, 287 
RGB (valeurs) 359 

definir 360 

ligne d'etat 355 
RLINK 193 

apel 193 
RLINK.DLL 

defini 167 
RLINK.EXE 

defini 167 
.RTF (fichiers) 

creation 96 
RTM (variable d'environnement) 22 
Run Arguments (option) 121 
Run to Cursor 

commande de menu 125 
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run-time, gestionnaire 22 

controle de la memoire utilisee 22 
rupture de ligne (texte statique) 295 
RWSJcon (section), WORKSHOP.INI 351 
RWS_OwnFloodfill (WORKSHOP.INI) 352 



-S (option BCC.EXE) 180, 211 

produit un fichier .ASM mais n'effectue pas 

l'assemblage 92 
Save with Default Device Colors (option) 361, 367 
scripts ressource 

commentaires 244 

controles dialogue 305 

fichiers .RC 192 

menus 318 

ressources definies par l'utilisateur, creer 399 

specifications de format 339 

table de chaines 340 
Scroll Bar (option Style) 278 
Scroll Bar Always (option de style List Box) 292 
Scroll Bar Style (boite de dialogue) 289 
segment de table virtuelle far 

nom et changement de nom 73 
segments 

controle 72 

non initialises 177 
segments (tables de chaines) 338 
segments de code 

enregistrement de tables virtuelles 71 

groupe 74 

nom et changement de nom 72, 74 

reduction 179 

stockage 179 
segments de donnees 

groupe 73 

nom et changement de nom 72 - 3-73 

suppression de tables virtuelles 71 
segments de fin WORD 

non initialises 177 
segments de pile 

segment de donnees et (bouton Advanced de 

TargetExpert) 28 
segments, mappe de 

champ ACBP et 179 



TLINKet 179 
Select All (commande) 

editeur Dialog 274 
Select All (commande), editeur Bitmap 348 
Select Font (boite de dialogue 268 
selecteur (outil) 273 
Selection (options) 305 
selectionner 

des controles 273 

des elements de menu 311 

toute l'image 348 

une boite de dialogue 265 
semantique 

erreurs (definition) 120 
separateurs (menus) 308 

aj outer 322 
sequences d'echappement, type C (editeur String) 
339 

Set Groups (commande) 281 
Set Groups (outil) 281 
Set Hot Spot (command) 383 
Set Order (commande) 282 
Set Order (outil) 281 
Set Tabs (commande) 280 
SHARE (DOS) 

et MAKE 211 
Show Identifiers (commande) 242 
Show Items (commande) 242 
Show Palette (commande) 359 
Show Resources (commande) 242 
Show Unused Types (commande) 243 
ShowWindow (fonction) 279 
.silent (directive MAKE) 224 
Simple Text (type de controle statique) 296 
Size (commande), editeur Dialog 265, 269, 276, 
285 
Size and Attributes (commande) 356 

editeur Icon 374 
Size Controls (boite de dialogue 285 

option Enter Values 287 
soft (mode de debogage) 139 
Sort (option de style List Box) 292 
sorties 

verification pour un programme 222 
souligner les caracteres 
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dans les menus 314 
souris 

bouton droit (editeur Bitmap) 346 

d'expression 129 
specificateurs de format 

hexadecimal 339, 399 

octal 399 
Split Horizontal (commande) 354 
Split Vertical (command) 354 
Standard stack frame 

commande 66 
Static Style (boite de dialogue) 295 
statique en forme d'icone (controle boite de 
dialogue) 272 

Step Over (commande de menu) 122 
structures 

indefinies 87 

longueur de zero 87 

violations ANSI 87 
style (boites de dialogue), controles 277 
styles de boite de dialogue 266 
styles de boite de dialogue (boite de dialogue 
Window Style) 266 

styles de cadre (boite de dialogue Window Style) 
266 

styles de ligne (editeur Bitmap) 364 
Stylo 

styles de ligne 364 

options de couleur 349 
suivi d'expressions 

aj outer 127 
sujets 

choix dans les boites de dialogue 10 
supprimer 

action TLIB 206 

expressions de suivi 129 

identificateurs 256 

point d'arret 133 - 6-134 
.swap (directive MAKE) 224 
symboles 

affichage des declarations 18 

Visualisation dans le code source 20 
syntaxe 

erreurs (definition) 119 

TLINK 167 



System Menu (style), boites de dialogue 266 
System Modal (style), boites de dialogue 267 



-T- (option BCC.EXE) 180 - 9-181 

suppression des options assembleur 92 
Tab Set (outil) 280 
Tab Stop (attribut de controle) 279 
Tab Stops (option de style List Box) 291 
table de liaison integrale 91 
table des symboles 121 

passer de l'une a l'autre 139 
tables 

options de compilateur 50 - 3-60 
tables de chaines 335 

astuces et reserves 478 

definition 234 

deplacement 340 

ecran de l'editeur String 337 

editer 340 

identificateurs 338 

modifier 340 

nommer 343 

projet exemple 341 

script ressource 340 

segments 338 

utilisation de la memoire 338 

valeurs d'identificateur 337 

valeurs hexadecimales 339 
tables de raccourcis 

editer 328 
tables virtuelles 

controle 79 

enregistrement dans le segment de code 71 

externes 

option en ligne de commande 79 

locales 

option en ligne de commande 79 

option en ligne de commande 79 

pointeurs 32 bits 71 

smart 

option en ligne de commande 79 
tabulation 

dans les menus 315 
taille de seuil 
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variables globales far, definition] 71 
taquets de tabulation, controles de boite de 
dialogue 280 

Target Windows Version (boite de dialogue File 
Preferences) 259 
TargetExpert 

utilisation 33 
-Tchaine (option BCC.EXE) 

passage de chaine a l'assembleur 92 
Test Dialog (commande) 301 
Test Menu (fenetre), changer l'affichage 310 
Test Menu (fenetre), menu surgissant, afficher 310 
Test Menu (volet), editeur Menu 309 
tester 

boites de dialogue 301 

menus 317 
Text Editor (boite de dialogue FilePreferences) 258 
texte 

chaines, terminees par un zero 400 

couleur 14 

editeur Bitmap 352, 361 

images bitmap 361, 352 

mise en surbrillance de la syntaxe (couleurs) 14 
texte de message 

editer 335 

traduire 335 
texte statique 272 

texte statique (controle boite de dialogue) 272 
Thick Frame (style), boites de dialogue 267 
'this' (pointeur) des fonctions membres 'pascal' 78 
tilde (~), symbole de fichier de sauvegarde 259 
TLIB 

erreurs 403 
TLINK (editeur de liens) 

bibliotheques 171 

mathematiques et 172 

champ ACBPet 179 

compilateur de lignes de commande et 171 

controle de mise en garde 181 

demarrage 167 

ecrasement 178 

erreurs 403 

de startupfile 168 

fichier de configuration 169 
exemple 169 



fichiers de recherche 170 

informations de debogage 181 

informations de debogage dans les 

fichiers .OBJ et 177 

mappe de fichier executable genere par 1 78 

modules non-C et 178 

options 173 

alignement des pages (/A) 176 

application .COM (/t) 180 

bibliotheques, ignorer (/n) 178 

controle de mise en garde (/w) 181 

dictionnaires etendus (/E) 177 

dictionnaires etendus (/f) 177 

difference majuscules/minuscules (/C) 176 

DLL (/Twe) 181 

executable Windows (/Tw) 181 

extensions de fichiers 169 

fichiers application (/Tw) 181 

fichiers de mappe (/m) 178 

fichiers executables (/Tw) 181 

fichiers mappe (/m), segments des 179 

/Gx ("Goodies") 177 

/i (segments de fin non initialises) 177 

ignorer les dictionnaires etendus (/e) 177 

informations de debogage (/v) 181 

/l (numeros de lignes du code source) 177 

memoire etendue (/yx) 182 

memoire paginee(/ye) 182 

/n (ignorer les bibliotheques par defaut) 178 

/o (ecrasement) 178 

option application (/Td) 180 

segments de fin non initialises (/i) 177 

stockage de segments de code (/P) 179 

taillede la pile (/S) 180 

/Tw (fichiers application) 181 

type d'application (/a) 175 

/v (informations de debogage) 181 

/w (controles de mise en garde) 181 

/x!82 

/ye (memoire paginee) 182 

/yx (memoire etendue) 182 
syntaxe 167 
TLINK.CFG 169 
exemple 169 
TLINK32 
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TLINK32 (editeur de liens) 

bibliotheques 172 

fichier de configuration 169 

options 

adresse debase (/B) 176 
majuscules/minuscules (/c) 176 
nombre maximum d'erreurs (/Enn) 177 
options application (/Tp) 181 

RLINKet 167 
TLINK32.CFG 169 
Tools (palette) 

editeur Dialog 270 

editeur Bitmap 346 
TOUCH.EXE 

description 209 
touches 

definir comme raccourcis 323 

editeur de texte 399 
Trace des messages 143 
Trace Into (commande de menu) 124 
TrackPopupMenu (fonction) 308 
traducteurs 

derogation aux valeurs par defaut 33 

installation 42 
traduire un texte de message 335 
tramees (polices) 386 

transtyper les identificateurs de ressource 251 
Turbo Assembler 

defaut 91 
TURBOC.CFG 

description 48 
TurboMenus 

utilisation 9 
-tW (option BCC.EXE) 

compilation avec toutes les fonctions far 

exportables 74 
-tWD (option BCC.EXE) 

compilation sous forme de DLL, toutes fonctions 

exportables 75 
-tWDE (option BCC.EXE) 

compilation sous forme de DLL, avec fonctions 

explicit _export exportables 76 
-tWE (option BCC.EXE) 

compilation avec fonctions explicit _export 

exportables 74 



-tWS (option BCC.EXE) 

compilation avec rappels smart 75 
-tWSE (option BCC.EXE) 

compilation avec rappels smart 75 
type d'element (menus) 313 
types de donnees 

char 63 

hexstring 399 
types de fichier 

.CUR 381 

.DLG 302 

.FNT 388 

.ICO 371 

choisir 239 

ressource 

choisir 239 

u 

-u (option BCC.EXE) 210 

annulation 93 

caracteres de soulignement 65 
lundef (directive MAKE) 224 

description 228 
Undo (outil), editeur Dialog 287 
Undo Levels (boite de dialogue FilePreferences) 
258 
unites dialogue 304 

definition 265 
UNIX 

conformite de langage 66 

portage de fichiers 66 
User Button (controle) 288 

V 

-v (option BCC.EXE) 79, 181 

compatibilite d' arguments de classes 78 

compatibilite de pointeur 'this' dans les fonctions 

membres 'pascal' 78 

compatibilite de pointeur de classe de base 
virtuelle 78 

informations de debogage 67 

pointeurs de table virtuelle 79 

tables virtuelles C++ 79 
s-Vc (option BCC) 78 
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valeurs 

visualiser 126 
valeurs de registres 132 
valeurs hexadecimales 

ressources definies par l'utilisateur 400 

tables de chaines 339 
valeurs numeriques, notation, ressources definies 

par l'utilisateur 399 
Variable (option Owner Drawing) 291 
variable, largeur de police 389 
variables 

alignement automatique de mot 68, 76 

communes 65 

globales, far 71 

modifier la valeur 130 

registres 64 

suivi 126 
variables communes 65 
variables d'environnement 

avec MAKE 210 

et DPMI 21 
variables d'instance 

ajout (ClassExpert) 113 

suppression (ClassExpert) 113 
variables far 71 
variables globales 

alignement de mot 68, 76 
vectorielles (polices) 386 
VERSIONINFO 

definition 235 
Vertical Scroll (style), boites de dialogue 267 
-vi (option BCC.EXE) 

fontions en ligne C++ 67 
View (menu) 

editeur Menu 310 
View as Pop-up (commande), editeur Menu 310, 
316 

View Source (commande) 135 
virgule flottante 

bibliotheque mathematique et 172 

bibliotheques 64 

option d'affichage 128 

rapide 64 
virtuel (touches de raccourci) 324 
Visible (attribut de controle) 279 



Visible (style), boites de dialogue 268 
visualisation 

dans l'EDI Windows, symboles dans le code 20 

de la hierarchie d'un objet 17 

DE code source 135 
visuel 

generation d'applications 95 
vitesse optimisation 81 
-Vm (options BCCEXE) 

pointeurs membres C++ 77 
volet de fenetre actif (editeur Bitmap) 354 
volets de fenetre 

editeur Bitmap 354 

w 

-wxxx (options BCC.EXE) 181, 210 

avertissements 87 

console monothread NT 92 

definir les options par defaut 211 
Want Return (option), boite de dialogue Edit Text 
Style 294 
warn pragma 87 
Watch (commande) 127 
Watch (fenetre) 127 

Watch Properties (boite de dialogue) 127 
-WCDE- (option BCC32.EXE) 

DLL de console monothread NT 93 
-WD (option BCC.EXE) 

compilation sous forme de DLL, toutes fonctions 
exportables 75 
-WCD- (option BCC32.EXE) 

DLL de console monothread NT 93 
-WDE (option BCC.EXE) 

compilation sous forme de DLL, avec fonctions 
explicit _export exportables 76 
-WE (option BCC.EXE) 

compilation avec fonctions explicit _export 

exportables 74 
White Frame (type de controle statique) 296 
White Rectangle (type de controle statique) 296 
Width (option), polices 390 
WIN.INI 

instruction "LOAD=" 477 

modification avec BWCC 476 
Win32 261 
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Window Style (boite de dialogue) 265 

bouton Fonts 268 

Caption (style de cadre) 266 

styles de boite de dialogue 266 

styles de cadres 266 
Windows 

editeur Notepad 244 

raccourcis predefinis 329 

valeurs d'identificateurs de table de chaines 338 

Presse-papiers 

copier une ressource 247 
Windows NT 261 
WINDOWS.H 324 
WinSight 

aspect 141, 143 

demarrage 141 

presentation 141 
WINSPCTR.BIN 162 
WINSPCTR.LOG 162 
WinSpector 

Demarrage 153 

DFA (traitement de donnees) 162 

fichier .MAP 164 

file d'attente des messages 159 

ilnformations systeme 161 

Modules 160 

registres 158 

taches 159 

tas USER etGDIl 60 

WINSPCTR.LOG 154 
-WM- (option BCC32.EXE) 

DLL de console monothread NT 93 
WM_COMMAND (message) 323 
WM_COMPAREITEM (message) 290 
WM_CTLCOLOR (message) 296 
WM_DELETEITEM (message) 290 



WM_DRAWITEM 288, 290, 298 
WM_ENTERIDLE (message) 267 
WM_MEASUREITEM (message) 290, 298 
WM_SYSCOMMAND (message) 323 
WORKSHOP.INI 

fixer les problemes de remplissage 351 
-WS (option BCC.EXE) 

compilation avec rappels smart 75 
WS_OVERLAPPED (style) 269 
WS_VISIBLE (style) 279 
-WSE (option BCC.EXE) 

compilation avec rappels smart 75 
WYSIWYG (option d'affichage) 305 



-X (option BCC.EXE) 

deactivation des informations 
d'auto-dependance 65 
gestion d'exceptions 80 



-y (option BCC.EXE) 

numeros de ligne 67 
/ye option TLINK (memoire paginee) 182 
/yx option TLINK (memoire etendue) 182 



zone client (boites de dialogue) 267 
zoom (outil) 348 
Zoom In (commande) 348 
Zoom Out (commande) 348 
-zV (options BCC.EXE) 

segments de table virtuelle far 73 
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